Are you new to Sugar?
The SoaS download is found here: Sugar on a Stick. Basic instructions are found below:
Sugar on a Stick installation instructions
Detailed installation instructions for Windows and booting instructions are available. There is also a guide to exploring Sugar.
- Download the latest Sugar on a Stick .iso file.
- Insert a USB stick of 2 GB or greater capacity into your computer.
- With root user permissions at a terminal or console command line, use the command
df -Th or
blkid to get the USB device node name.
You should see something like the following:
[root@MyComputer ~]# df -Th
Filesystem Type Size Used Avail Use% Mounted on
rootfs rootfs 20G 5.5G 14G 29% /
devtmpfs devtmpfs 1.6G 0 1.6G 0% /dev
tmpfs tmpfs 1.6G 788K 1.6G 1% /dev/shm
tmpfs tmpfs 1.6G 1.3M 1.6G 1% /run
tmpfs tmpfs 1.6G 0 1.6G 0% /sys/fs/cgroup
tmpfs tmpfs 1.6G 0 1.6G 0% /media
/dev/loop0 iso9660 668M 668M 0 100% /run/soas
/dev/sdc1 vfat 2.0G 2.0G 53M 98% /run/media/MyAccount/LG
/run/media/MyAccount/ path is the new, Fedora 17 standard mount point for removable media.
/media/MyMountPoint is common on other operating systems.)
[root@MyComputer ~]# blkid
/dev/sda1: LABEL="Fedora-20" UUID="8962913a-c335-4c3b-b3ed-90fbb9c97580" TYPE="ext4" PARTUUID="1549f232-01"
/dev/sdc1: LABEL="LIVE" UUID="D2AC-5056" TYPE="vfat" PARTUUID="000056b3-01"
/dev/loop0: UUID="2013-12-12-01-40-45-00" LABEL="Fedora-Live-SoaS-x86_64-20-1" TYPE="iso9660" PTUUID="461863db" PTTYPE="dos"
- (Additional disk drive partitions may be listed on your computer.)
- The mount point (Mounted on), Filesystem, Size, and LABEL should help you identify what you want.
- Unmount the USB device filesystem:
/run/media/MyAccount/ path is the new, Fedora 17 standard mount point. Other operating systems may use
- (You should have the isomd5sum package installed so that the following installation script can verify the download.)
- Load: Execute the following installation command, as the root user, in one command line with many options:
livecd-iso-to-disk --reset-mbr --overlay-size-mb 500 --home-size-mb 800 --unencrypted-home /path/to/downloaded.iso /dev/sd?1
- The '
?' in the final parameter represents the target USB device scsi drive node, such as
sdc1, etc., and
/path/to/downloaded.iso is the location and name of the .iso file.
- The operating system will occupy ~670 MB, and the overlay and home size arguments, 500 and 800, were selected to fit in a 2 GB device. These may be adjusted depending on your preferences and device capacity (see LiveOS image). SoaS 10 can be squeezed into a 1 GB device with 160 and 170. On a 4 GB device, one might use 1000 and 1600 for the size arguments.
The installation transcript should look something like the following:
[root@MyComputer ~]# /run/soas/LiveOS/livecd-iso-to-disk --reset-mbr --overlay-size-mb 500 --home-size-mb 800 --unencrypted-home /home/MyAccount/Downloads/Fedora-Live-SoaS-x86_64-20-1.iso /dev/sdc1
Fragment sums: 9bfe23577651c88dcfb78c76ac3a28a5c53eead4561e3bdc5921b8b2e748
Fragment count: 20
Press [Esc] to abort check.
The media check is complete, the result is: PASS.
It is OK to use this media.
Copying live image to target device.
630,784,000 100% 1.96MB/s 0:05:06 (xfr#1, to-chk=0/1)
8,192 100% 0.00kB/s 0:00:00 (xfr#1, to-chk=0/1)
Updating boot config file
Initializing persistent overlay file
500+0 records in
500+0 records out
524288000 bytes (524 MB) copied, 216.717 s, 2.4 MB/s
Initializing persistent /home
800+0 records in
800+0 records out
838860800 bytes (839 MB) copied, 344.643 s, 2.4 MB/s
Formatting unencrypted /home
mke2fs 1.42.8 (20-Jun-2013)
OS type: Linux
Block size=4096 (log=2)
Fragment size=4096 (log=2)
Stride=0 blocks, Stripe width=0 blocks
51296 inodes, 204800 blocks
10240 blocks (5.00%) reserved for the super user
First data block=0
Maximum filesystem blocks=209715200
7 block groups
32768 blocks per group, 32768 fragments per group
7328 inodes per group
Superblock backups stored on blocks:
32768, 98304, 163840
Allocating group tables: done
Writing inode tables: done
Creating journal (4096 blocks): done
Writing superblocks and filesystem accounting information: done
tune2fs 1.42.8 (20-Jun-2013)
Setting maximal mount count to -1
Setting interval between checks to 0 seconds
Installing boot loader
Target device is now set up with a Live image!
- Boot: Insert the USB stick into a bootable USB port on your computer. Set the option to "boot from USB" in your computer's BIOS setup, and then start up the computer.
/dev/sd?1 with a new device node for the second USB/SD device that you want to load with Sugar on a Stick.
Detailed installation instructions for GNU/Linux and booting instructions are available. There is also a guide to exploring Sugar.
GNU/Linux users may also want to install the Sugar packages on their favorite distro, apart from Sugar on a Stick.
Apple Mac OS X
The instructions below are based on the Ubuntu Web page at <http://www.ubuntu.com/download/desktop/create-a-usb-stick-on-mac-osx>.
- Prepare: These instructions are for 32-bit and 64-bit processors.
- Download the latest Sugar on a Stick .iso file.
Here is a simple way to load a bootable USB on a Mac.
- Enter the Terminal:
diskutil list. You should see all the disk drives you have inserted into your computer.
- Insert the disk drive to which you want to write Sugar on a Stick.
diskutil list again. You should see that your USB drive has been added to the list. If not, wait a while and repeat.
hdiutil convert -format UDRW -o <Sugar on a Stick image file>.img <Sugar on a Stick image file> to convert the image into a bootable format.
sudo diskutil unmountDisk <device name> to unmount the disk (it will not be ejected).
sudo dd if=<Sugar on a Stick image file>.img.dmg of=<device name> bs=1m.
sudo will ask for your password, and then
dd will start writing the disk file.
dd finishes writing the disk file, type
sudo diskutil eject <device name>.
- Boot: Insert the USB stick into a USB port on your computer, then reboot and press and hold the Option key while rebooting. You should see a list of all the EFI-recognizable USB drives that can be bootstrapped. If Sugar on a Stick is not one such drive, it cannot be bootstrapped: you need rEFInd (a fork of rEFIt).
- Have a MacBook? Consider these options:
- MacBook Persistent SoaS v5 USB EFI Boot
- Bootable CD of Trisquel 4.5 for MacBook Air
- See other installation variations at Sugar Creation Kit
- Burning a CD from an .iso file on a Mac
- Have an iBook or PowerPC Mac?
- See Ubuntu/PPC and Fedora#PowerPC.
Alternative installation instructions for Mac OS X. Also, these older installation instructions and booting instructions may be consulted.
There is also a guide to exploring Sugar.
Do you have an OLPC XO?
Some alternate installations
- Once you download, and then burn or load a Sugar on a Stick (SoaS) .iso file, and boot it, the running Fedora 17 SoaS Live CD/USB may be used to install Fedora with Sugar to a hard disk or a 4 GB USB stick with the
- - You start with a SoaS LiveOS image, and then load an uncompressed version onto the hard disk or USB stick.
- - The Fedora-17-Live-SoaS.iso file is a 509 MB download.
- If you have a high-speed Internet connection,
Fedora with the Sugar graphical learning environment may be installed to a hard disk or a a 4 GB USB stick with a Netinstall CD.
- - Not a compressed LiveOS image like SoaS, but all of Sugar.
Do you use GNU/Linux?
- See these links to pages on the Sugar Labs wiki for GNU/Linux distributions where Sugar has been installed.
Are you a developer?
Virtual Machines on all platforms
More Virtual Appliances
Sugar included in other GNU/Linux operating systems, and older versions.
- Also includes some VMware Player Appliances
If you run into problems, you may want to consult the Talk:VirtualBox page for help.
Are you preparing a deployment without Internet access?
Are you looking for Sugar Activities?