SoaS Blueberry Instructions

From Sugar Labs
Revision as of 12:34, 25 February 2010 by LFaraone (talk | contribs) (→‎For Windows Users: clarify instructions, move out confusing alternatives.)
Jump to navigation Jump to search

For Windows Users

  1. Download the latest version of the Fedora LiveUSB Creator from FedoraHosted here.
  2. Plug a blank target USB flash drive (or SD Card) into your computer (1GiB or greater)
  3. Launch LiveUSB Creator.
  4. Select Sugar on a Stick v2 Blueberry in the drop-down menu on the upper-right side to download the liveUSB disk image.
  5. Adjust the Persistent Storage slider. This enables you to save the child's work in Sugar onto the device.
  6. Select your flash drive as the target and click the Create Live USB button.
  7. Wait for the process to finish, then close the LiveUSB Creator program.
  8. Stop your flash drive using the Safely Remove Hardware dialog and eject it.


  • If you do this often, you may want to download the Blueberry CD Image once. Then, when it comes to create the flash drive, hit the Browse button and select the downloaded file rather than selecting "Blueberry" from the menu as above.

For GNU/Linux Users

1-)Linux Users will use a slightly different approach than Windows Users to ensure maximum compatibility with different distributions. Please follow the instructions carefully to ensure your data is preserved.

If you are a Fedora User, run the following command:

yum install liveusb-creator

Then download soas-2-blueberry.iso and select it by using the Browse button. You can check to make sure that the .iso downloaded properly by comparing the sha1sum to the one here:[1](sha1sum)

sha1sum soas-2-blueberry.iso
  • Launch LiveUSB Creator and follow the instructions above.

2-)If you use any other distribution, download the image-writer tool from here and the live image from here.

This solution will not create a persistent storage overlay

  • Open a terminal and become root, either by using su or sudo.
  • Enter the following command: ./image-writer soas-2-blueberry.iso
  • WARNING: If you proceed here, your flash drive will be wiped!
  • The script will output a device name; confirm that it matches with your flash drive.
  • You will be notified once the process has finished.


4-)Unsupported instructions for creating a key with persistent storage for Blueberry: [3] and on other distributions are available here:[4]

For Mac OS X Users

The procedure for Mac OS X users is similar to the one for Linux users. Verify that you have an Intel processor, and not a PowerPC (PPC) G3, G4, or G5 processor Apple Macintosh. Mac users should be aware that they may be able to prepare their flash drive on a Mac, but depending on the generation of the hardware used, they may need to use another computer to test whether the prepared flash drive works.

shasum ~/Downloads/soas-2-blueberry.iso
  • Download the image-writer tool for Macs from here:
  • Insert a flash drive. WARNING: your flash drive will be wiped in the next step!
  • Execute the following command in Terminal: cd Downloads; python image-writer-mac soas-2-blueberry.iso
  • Proceed as stated in the instructions for Linux Users.

Boot Helper

If your machine doesn't support booting from USB devices, then download the soas-2-boot.iso and burn it to a CD. ImgBurn is a free Windows application to do so, in case your current computer does not come with such a software.

  • Use the Windows Explorer to name your USB flash drive FEDORA (from the Properties dialog for your device), as otherwise, it won't be recognized by the boot-helper CD.
  • Put both the boot-helper CD and the USB flash drive in your computer and let it boot from the CD.