Are you new to Sugar?

The easiest way to get started is to use Sugar on a Stick. Basic instructions are found below. A more detailed Sugar-on-a-Stick Creation Guide is also available.

MS Windows

(1) Prepare: Download the Fedora Live USB Creator from FedoraHosted
(2) Download: Download the Sugar-on-a-Stick iso.
  (3) Burn: Insert a USB flash drive (or SD Card) with 1 GB or more of free space into your computer and launch Fedora Live USB Creator to create a Sugar-on-a-Stick bootable image.
(4) Boot: Insert the USB stick into a USB port on your computer. Set the option to "boot from USB" in your computer's BIOS, and then start up the computer.

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

GNU/Linux

GNU/Linux users may want to install the Sugar packages on their favorite distro.

  (1) Prepare: Use this script http://bit.ly/livecd-iso-to-disk to create a bootable image. (Run chmod +x livecd-iso-to-disk.sh after you download the script to make it executable.)
(2) Download: Download the Sugar-on-a-Stick iso.
  (3) Burn: Execute, as the root user, in one command with arguments, the following:

./livecd-iso-to-disk.sh --format --reset-mbr --overlay-size-mb 200 --home-size-mb 200 --delete-home --unencrypted-home /path/to/source.iso /dev/sd?1

where '?' in the final parameter represents the target bootable device node, such as sdb1 or sdc1, etc.
(4) Boot: Insert the USB stick into a USB port on your computer. Set the option to "boot from USB" in your computer's BIOS, and then start up the computer.

Detailed installation instructions for GNU/Linux and booting instructions are available. There is also a guide to using Sugar on a Stick.

Apple OSX

These instructions are only for 64-bit machines. You may want to refer to the Virtual Machines instructions below.

  (1) Prepare: Use this script http: to create a bootable image.
(2) Download: Download the Sugar-on-a-Stick iso. Be sure to download a 64-bit image.
  (3) Burn: Execute...
(4) Boot: Insert the USB stick into a USB port on your computer. Set the option to "boot from USB" in your computer's BIOS, and then start up the computer.

http://spins.fedoraproject.org/soas/#downloads Alternative installation instructions for OSX Also:[1] and booting instructions are available. There is also a guide to using Sugar on a Stick.

Advanced users

  • the Sugar_Creation_Kit
customizing Sugar on a Stick;
• a detailed Customization Guide; and
• additional instructions for using VirtualBox and other virtual machines.

Virtual Machines on all platforms

It is recommended that you read README_FIRST before starting.

(1) Prepare: Download Sun Virtualbox
(2) Download: Download these three files:
      soas-v3-Mirabelle.mf
      soas-v3-Mirabelle.ovf
      soas-v3-Mirabelle.vmdk
Note that on some browsers on OSX, the file extensions are reset upon download. You may have to modify them to match those shown above.
sugarroot is the root password.
(3) Launch: Virtualbox
(4) Import: soas-v3-Mirabelle.ovf from the Import Appliance option under the File menu.

Other virtual machine may also work but have not undergone testing with our images.

Do you have an OLPC XO?

   
Upgrade to Sugar 0.88 with Fedora 11 and Gnome
Upgrade to Sugar 0.84 with Fedora 11 and Gnome.
OLPC:OS images
Developers may experiment with Updating XOs to the latest Sugar on a Stick release.

Are you looking for Sugar Activities?

Visit the Activity Portal  

Do you use a GNU/Linux distro?

Select your favorite distribution                      
Or try a Live USB version of Sugar  , v4 alpha with Sugar 0.89.1 and Fedora 14 (Branched)
  Trisquel on a Sugar Toast (Trisquel 3.0 Dwyn)

Are you a systems developer?

  Learn how to get setup on the Supported systems page.
Some additional references you may find useful:
jhbuild
Gitorious source code repository
Virtual machine or emulator image files
• Adding Sugar to your favorite distro...

Are you preparing a deployment without Internet access?

See Sugar Creation Kit