Downloads

Are you new to Sugar? [MS Windows] [GNU/Linux] [Apple Mac OS X] [advanced users] Do you have an OLPC XO? Do you use GNU/Linux? Do you use a virtual machine? Are you a developer? Are you preparing a deployment without Internet access? Are you looking for Sugar Activities?

Are you new to Sugar?

The quickest download is Sugar on a Stick. Basic instructions are found below:

Sugar on a Stick installation instructions

MS Windows

Prepare: Download the Fedora Live USB Creator from FedoraHosted. Download the latest Sugar on a Stick .iso file. Load: Insert a USB flash drive (or SD Card) with 2 GB or more of free space into your computer and launch Fedora Live USB Creator to create a Sugar-on-a-Stick bootable image. Note: Be sure to set the persistent storage slider to a non-zero value. Boot: Insert the USB stick into a USB port on your computer. Set the option to "boot from USB" in your computer's BIOS setup, and then start up the computer.

Detailed installation instructions for Windows and booting instructions are available. There is also a guide to exploring Sugar.

---

GNU/Linux

Download the latest Sugar on a Stick .iso file. Prepare: (with root user permissions at a terminal or console command line) Create a mount point directory: mkdir /media/soas Mount the .iso file to make it accessible as a disk: mount /path/to/downloaded.iso /media/soas/ (Where /path/to/downloaded.iso is the filesystem path, or fully specified name, of the downloaded .iso file.) This is the source for the installation, and must remain mounted until the installation is complete. Insert a USB stick of 2 GB or greater capacity into your computer. 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 509M 509M 0 100% /media/soas /dev/sdc1 vfat 995M 983M 13M 99% /run/media/MyAccount/LG (The /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-17" UUID="8962913a-c335-4c3b-b3ed-90fbb9c97580" TYPE="ext4" /dev/sdc1: LABEL="LIVE" UUID="A7B2-6C07" TYPE="vfat" /dev/loop0: LABEL="Fedora-17-x86_64-Live-SoaS.iso" TYPE="iso9660" (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: umount /run/media/MyAccount/MyUSBdiscMountPoint (The /run/media/MyAccount/ path is the new, Fedora 17 standard mount point. Other operating systems may use /media/MyMountPoint.) (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: /media/soas/LiveOS/livecd-iso-to-disk --reset-mbr --overlay-size-mb 500 --home-size-mb 900 --delete-home --unencrypted-home /path/to/downloaded.iso /dev/sd?1 The '?' in the final parameter represents the target USB device scsi drive node, such as sdb1 or sdc1, etc., and /path/to/downloaded.iso is the location and name of the .iso file. The operating system will occupy ~510 MB, and the overlay and home size arguments, 500 and 900, were selected to fit in a 2 GB device. These may be adjusted depending on your preferences and device capacity (see LiveOS image).       The installation transcript should look something like the following: [root@MyComputer ~]# /media/soas/LiveOS/livecd-iso-to-disk --reset-mbr --overlay-size-mb 500 --home-size-mb 900 --delete-home --unencrypted-home /home/MyAccount/Downloads/Fedora-17-x86_64-Live-SoaS.iso /dev/sdc1 Verifying image... /home/MyAccount/Downloads/Fedora-17-x86_64-Live-SoaS.iso: 470134baa7e48085595243e53b55d41e Fragment sums: 7de3e14f3d5aa991343fa35bdfe3a1db59d578db95a844a63d22de789de1 Fragment count: 20 Press [Esc] to abort check. Checking: 100.0% The media check is complete, the result is: PASS. It is OK to use this media. Copying live image to target device. squashfs.img 512344064 100% 43.04MB/s 0:00:11 (xfer#1, to-check=0/1) sent 512406681 bytes received 31 bytes 44557105.39 bytes/sec total size is 512344064 speedup is 1.00 osmin.img 8192 100% 0.00kB/s 0:00:00 (xfer#1, to-check=0/1) sent 8265 bytes received 31 bytes 16592.00 bytes/sec total size is 8192 speedup is 0.99 Updating boot config file Initializing persistent overlay file 500+0 records in 500+0 records out 524288000 bytes (524 MB) copied, 5.1728 s, 101 MB/s Initializing persistent /home 900+0 records in 900+0 records out 943718400 bytes (944 MB) copied, 152.195 s, 6.2 MB/s Formatting unencrypted /home mke2fs 1.42.3 (14-May-2012) Filesystem label= OS type: Linux Block size=4096 (log=2) Fragment size=4096 (log=2) Stride=0 blocks, Stripe width=0 blocks 57600 inodes, 230400 blocks 11520 blocks (5.00%) reserved for the super user First data block=0 Maximum filesystem blocks=239075328 8 block groups 32768 blocks per group, 32768 fragments per group 7200 inodes per group Superblock backups stored on blocks: 32768, 98304, 163840, 229376 Allocating group tables: done Writing inode tables: done Creating journal (4096 blocks): done Writing superblocks and filesystem accounting information: done tune2fs 1.42.3 (14-May-2012) 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. To create more Sugar Sticks on other 1 GB or greater USB or SD devices, while running Sugar on a Stick, in the Terminal Activity, execute this command as the root user: /run/initramfs/live/LiveOS/livecd-iso-to-disk --reset-mbr --overlay-size-mb 300 --home-size-mb 175 --delete-home --unencrypted-home /run/initramfs/livedev /dev/sd?1 Replace /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

DRAFT: These instructions are incomplete. Please help with testing and documentation. In the meantime, we recommend the Virtual Machines instructions below.

Prepare: These instructions are only for 64-bit processor machines. (To identify the processor type, choose Apple menu > About This Mac. A small window will appear titled About This Mac. The processor type is displayed in this window. Sugar on a Stick is for the Intel processor only.) Download the latest Sugar on a Stick .iso file. Be sure to download a 64-bit image. Load: Help: Does someone have a simple way to load a Live USB on a Mac? Here is a simple way to recognize a bootable USB on a Mac. Go to rEFIt (http://refit.sourceforge.net/) and make a bootable cd. There is no need to install rEFIt on your mac. In fact installing rEFIt may make it impossible to upgrade the Mac OS to a newer version later on (personal experience, I had to do a clean install). Put the rEFIt CD in and hold the option key after turning the computer on. The Mac will recognize the CD because it uses EFI and then the CD will recognize the bootable USB. How to Burn a rEFIt CD You can rename the .cdr file to .iso for use in GNU/Linux. Building and Booting a Live USB stick on a Mac Boot: Insert the USB stick into a USB port on your computer. Is this correct?: During the startup sound, press and hold the c key. If the Apple logo appears, Sugar is not booting. Restart and try again. the c key must be pressed during the startup sound and you must continue to hold it down. you may release the c key once the Sugar logo appears. 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?

Upgrade to the latest olpc:Releases from OLPC. Upgrade to Dextrose (requires a developer key). Experiment with Updating XOs to the latest Sugar on a Stick release.

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 liveinst command.

- 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.

- This requires a high-speed Internet connection for software component downloading during installation.

Do you use GNU/Linux?

Please note:
Development changes occur rapidly, and the documentation here lags the current state of systems development.
For the latest information on any development project, visit their work sites.

Logo	Name	Latest Sugar	Notes
	Fedora_18	0.96.2	Primary distribution for Sugar
	OLPC	0.96.2	Prepared for XO laptops
	openSUSE	0.96.2	Part of the Linux for Education (Li-f-e) series
	Sugar on a Stick	0.96.1	Live CD/USB of Sugar Learning Environment
	Mageia	0.95.1	Forked from Mandriva
	Trisquel	0.94.1	Based on Ubuntu 11.10
	Harmonic Distribution	0.94.1	See also Sweets Distribution and Sugar Network
	ElementaryOs	0.94.1	Based on Ubuntu 10.10 & Sweets Distribution
	Tuquito	0.94.1	Based on Ubuntu 10.10 & Sweets Distribution
	Fusion Linux	0.94.1	Remix of Fedora 16 with GNOME 3.2.1
	Linux Mint	0.94.1
	Dextrose	0.92.4	Prepared for XO laptops
	Debian	0.88.1
	Linux Mint Debian Edition	0.88.1
	Ubuntu	0.88.1	Use Sweets Distribution for Sugar
	Mandriva	0.88.0
	Caixa Mágica	0.88.0	Based on Mandriva 2010.1 repositories

Are you a developer?

Learn how to get setup on the Supported systems page. Some additional references you may find useful: Sweets, to launch Sugar using the Sugar Package Management System JHBuild Gitorious source code repository Virtual machine or emulator image files Adding Sugar to your favorite distro...

Virtual Machines on all platforms

	VirtualBox Appliances
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?

See Sugar Creation Kit

Are you looking for Sugar Activities?

Visit the Sugar Activity Library