Sugar Live Build is a complete bootable image containing Debian Linux, Sugar, the Sugar toolkits, and the demonstration activities.

• it can be booted from hard drive, flash drive, and optical media, automatically starting Sugar without persistence;

• it can be installed as a virtual machine, with persistence and password protection,

• it contains all build dependencies, configured source trees (git clones in /usr/src), and binaries (make install) for Sugar modules and the demonstration activity set.

For a pre-built ISO-9660 file see Downloads.

Rebuilding Sugar Live Build is not necessary if you just want to use it. You only need to rebuild if you plan to release a new image for others.

1. Install Debian 10 Buster;

2. Clone this repository;

git clone https://github.com/sugarlabs/sugar-live-build.git

3. Run the build script.

./build

When this is finished, look for a new file ending with .hybrid.iso, which is a bootable ISO-9660 file.

1. Open the build script with a text editor,

2. Look for the section that clones activities,

3. Clone each activity;

   clone https://github.com/username/repository.git ActivityName.activity

Above is a template. Use the URL of the repository. Replace ActivityName with the bundle name. Use .activity as the directory suffix.

Then rebuild.

Debian Live Build has documentation for more details.

A cache of packages is maintained by Live Build, so that repeated builds will avoid downloading what has already been downloaded. The cache is about 1.4 GB after our build of Debian Buster.

However, the cache is distribution version specific. For development of multiple distribution versions, you may use an instance of the approx package. This may be on a different system, or the same system as Live Build.

This is optional.

How to set up Live Build and approx together:

• install the approx package:

		sudo apt install approx

• edit the approx configuration file:

		sudo editor /etc/approx/approx.conf

• add entries for Debian:

		debian          http://ftp.debian.org/debian
		security        http://security.debian.org/

• edit your build file to switch to using approx,

		lb config \
		    --mirror-bootstrap http://approx:9999/debian \
		    --mirror-chroot-security http://approx:9999/security \

• clear the Live Build disk cache,

		sudo rm -rf cache

• run Live Build again.