Difference between revisions of "SoaS Blueberry Instructions"

From Sugar Labs
Jump to: navigation, search
(For GNU/Linux Users)
m (update Macintosh link)
 
(82 intermediate revisions by 12 users not shown)
Line 1: Line 1:
 
__NOTOC__
 
__NOTOC__
  
=== For Windows Users ===
+
== For Windows Users ==
  
[[Image:fedora-liveusb-creator.png|left|200px]]
+
Persons using PCs running Windows have two options for creating a Sugar/Blueberry USB flash drive:
  
* Download the latest version of the '''Fedora LiveUSB Creator''' from http://fedorahosted.org/liveusb-creator and extract it.
+
::'''Option #1:  Use LiveUSB Creator from within Windows to create a Sugar-on-a-Stick Live USB with a compressed filesystem.'''
* Plug a blank target USB flash drive into your computer (minimum 1-gigabyte). '''WARNING:''' this procedure erases all data already on the flash drive! Copy any existing data elsewhere first.
 
* Launch LiveUSB Creator.
 
* Select '''Sugar on a Stick v2 Blueberry''' in the drop-down menu on the upper-right side.
 
* Adjust the Persistent Storage slider. This enables you to save your work in Sugar onto the device.
 
* Select your flash drive as the target and click the '''Create Live USB''' button.
 
* Wait for the process to finish, then close the LiveUSB Creator program.
 
* Stop your flash drive using the '''Safely Remove Hardware''' dialog and eject it.
 
<br/>
 
  
=== For GNU/Linux Users ===
+
{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: white;"
 +
|-
 +
|valign=top|[[Image:fedora-liveusb-creator.png|left|300px]]
 +
|valign=top|
 +
# Download the latest version of the '''Fedora LiveUSB Creator''' from [https://fedorahosted.org/liveusb-creator/#Download FedoraHosted here].
 +
# Plug a blank target USB flash drive (or SD Card) into your computer (1GB or greater).
 +
# Launch LiveUSB Creator.
 +
# Select '''Sugar on a Stick v2 Blueberry''' in the drop-down menu on the upper-right side to download the liveUSB disk image.
 +
# Adjust the Persistent Storage slider. This enables you to save the child's work in Sugar onto the device.
 +
# Select your flash drive as the target and click the '''Create Live USB''' button.
 +
# Wait for the process to finish, then close the LiveUSB Creator program.
 +
# Stop your flash drive using the '''Safely Remove Hardware''' dialog and eject it.
 +
|}
  
Linux Users will use a slightly different approach than Windows Users to ensure maximum compatibility
+
::'''Option #2:  (ADVANCED USERS ONLY) Create a bootable Sugar/Blueberry USB flash drive that does not have a compressed filesystem.'''  This option requires at least a 4GB drive. 
 +
 
 +
::::'''WARNING:  MAKING A MISTAKE IN THIS PROCEDURE COULD WIPE YOUR PC'S HARD DISK!!!!'''
 +
 
 +
::# In Windows, download the latest version of the [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso Live CD image], and burn the image to a CD.
 +
::# Follow the instructions [[Sugar_on_a_Stick/ZyX-LiveInstaller |here]] to create the bootable Sugar/Blueberry USB flash drive by (i) booting the PC into Sugar with the CD and (ii) running ZyX-LiveInstaller within the Terminal activity.  You will also need a spare, blank (or erasable) USB flash drive -- preferably manufactured by a different manufacturer than the target USB -- to use as a swap drive during the procedure.  Any data on the swap drive will be wiped.
 +
 
 +
Notes:
 +
 
 +
* If you do Option #1 often, you may want to download the Blueberry [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso 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.
 +
 
 +
* Option #1 creates an SoaS that cannot detect when its drive space eventually runs out, causing stick failure.
 +
 
 +
* Option #2 creates a more-robust, more-stable drive whose free space can be monitored using the Terminal activity.  Non-compressed SoaS drives, however, are not bootable with a boot helper CD.
 +
 
 +
== 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.
 
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''
+
If you are a '''Fedora User''', run the following command:
** Launch LiveUSB the Creator and follow the instructions [[SoaS_Blueberry_Instructions#For_Windows_Users|above]].
+
 
* If you use any '''other distribution''', download the '''image-writer''' tool from [http://download.sugarlabs.org/soas/releases/image-writer here] and the live image from [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso here]. Unfortunately, image-writer will not allow you to save your work; it does not create a persistent storage overlay
+
<code>''yum install liveusb-creator''</code>
** Open a terminal and become root, either by using su or sudo.
+
 
** Enter the following command: ''./image-writer soas-2-blueberry.iso''
+
Then download [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso 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:[http://download.sugarlabs.org/soas/releases/SHA1SUM](sha1sum)
** '''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.
+
sha1sum soas-2-blueberry.iso
** You will be notified once the process has finished.
+
8022b68433295f12fbfffa66bf49205851a6a1e0
 +
 
 +
* Launch LiveUSB Creator and follow the instructions [[SoaS_Blueberry_Instructions#For_Windows_Users|above]].
 +
 
 +
2. If you use any '''other distribution''', download the '''image-writer''' tool from [http://download.sugarlabs.org/soas/releases/image-writer here] and the '''live image''' from [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso 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.
 +
 
 +
3. '''zyx-liveinstaller:''' [[Sugar on a Stick/ZyX-LiveInstaller]]
 +
 
 +
4. '''Instructions for installing with persistent storage for Blueberry: ''' [[Talk:SoaS Blueberry Instructions]]. See also [[Sugar on a Stick/Linux]].
 +
 
 +
== Boot Helper ==
 +
If your machine doesn't support booting from USB devices, then download the [http://download.sugarlabs.org/soas/releases/soas-2-boot.iso soas-2-boot.iso] and burn it to a CD. [http://www.imgburn.com/ ImgBurn] is a free Windows application to do so, in case your current computer does not come with such a software.
 +
 
 +
* Use the [[wikipedia:Windows Explorer|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.
 +
 
 +
If your boot hangs, you may need to modify the boot command by appending:
 +
 
 +
selinux=0
 +
 
 +
You do this by interrupting the Helper CD boot by hitting the Esc key once the initial splash-screen appears. You should see a list of four boot options. At this point, hit the Tab key. The command line should appear. Add selinix=0 to the end of the line and hit Return (or Enter). The boot should proceed from here as normal.
 +
 
 +
<!--
 +
template does not allow enough separation between disparate sections. Try using wiki sections with the ===section_title=== wikiformat.  See [[Wiki Team/Guide/Formatting]]. If that is not sufficient, a skin change would be required to avoid the newline and <br> workarounds.  Please post a screenshot of your issue. We are planning skin changes (see [[Wiki_Team/Roadmap/Wiki_skin_redesign]]). Comments are usually left on the Discussion/Talk pages for greater visibility and ease of linking. Changes to either page trigger watchlist notifications. Thanks again for your edits!
 +
-->
 +
== For Mac OS X Users ==
 +
{{Note/help|NOTE to Instruction Editors:|Please test and adjust instructions for the soon-to-be-released [[Sugar on a Stick/Mirabelle]]. Draft instructions at [[Sugar on a Stick/Beta]].}}
 +
 
 +
''Sugar on a Stick Blueberry and Strawberry images are for the Intel processor.''<br>
 +
''See [[#Older Mac with powerPC processor | Using Sugar with powerPC]] if you do not have an Intel processor.''
 +
* See also [[Macintosh]].
 +
 
 +
====To identify the Mac's processor and OS X version====
 +
Choose '''Apple menu''' > About This Mac.  A small window will appear titled ''About This Mac''.  The processor type should be in the window.
 +
 
 +
====To download Sugar on a Stick====
 +
*Download the liveUSB image [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso soas-2-blueberry.iso]
 +
* Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br>
 +
For protection against tampering and transmission errors, '''always compare the checksum of each download'''.
 +
 
 +
====To calculate a file's SHA-1 checksum====
 +
Open the Terminal Utility and type into the Terminal Window. Press the return key to run the command.
 +
<!-- "md5" will work too, but creates a different checksum  e.g. ''$ md5 /Downloads/soas-2-blueberry.iso'' -->
 +
*Mac OS version ≥10.6<br> <big> <code> shasum ~/Downloads/soas-2-blueberry.iso</code></big>
 +
* Mac OS version ≤10.5<br> <big> <code> openssl sha1 ~/Downloads/soas-2-blueberry.iso</code></big>
 +
* Compare the result to the official [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum] stored at Sugar Labs.
 +
 
 +
 
 +
'''To install Sugar onto a Stick'''
 +
* Download the  [http://download.sugarlabs.org/soas/releases/image-writer-mac  image-writer for Mac ]<br>''PythonLauncher may automatically open the file; don't allow that, just download it.''
 +
 
 +
* Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br>For protection against tampering and transmission errors, '''always compare the checksum of each download'''.
 +
 
 +
* Eject all USB drives. Insert the flash drive you wish to install Sugar on a Stick.<br>'''WARNING:''' your entire flash drive will be overwritten in the next step!  All partitions will be erased.
 +
 
 +
* Open the Terminal Utility and type into the Terminal Window. Press the return key to run the command.<br><big><code>cd ~/Downloads;  python  image-writer-mac.py  soas-2-blueberry.iso</code></big>
 +
 
 +
<!-- extra spaces would add code legibility, how to wiki format it? Try <big><code>codetext</code></big> or <big><big><code>codetext</code></big></big>  Thank you for your contributing to the wiki! We've really needed help in this area.  Please continue.  --User:FGrose -->
 +
 
 +
{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: white;"
 +
|-
 +
|valign=top|[[Image:image-writer-mac.png|left|300px]]
 +
|valign=top|
 +
|}
 +
 
 +
 
 +
'''To create a Boot Helper CD'''<br>
 +
* Download the USB boot helper [http://download.sugarlabs.org/soas/releases/soas-2-boot.iso soas-2-boot.iso]
 +
* Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br>For protection against tampering and transmission errors, '''always compare the checksum of each download'''.
 +
* Open the Disk Utility. Drag the downloaded soas-2-boot.iso to the bottom of the list.
 +
* Select the Disc Image in the list, then press the Burn button.
 +
* Insert a blank disc when prompted.
 +
 
 +
 
 +
'''To boot Sugar on a Stick'''<br>
 +
* insert the USB drive loaded with Blueberry flavor Sugar on a Stick.
 +
* insert the Boot Helper CD.
 +
* Press the Power Button on the intel Mac. If a dialog box appears, press the Restart Button.
 +
* During the startup sound, press and hold the letter C.<br> 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.
 +
 
 +
===Suggestion: ===
 +
Using a boot helper disc may fix the bugs listed below. See [[Talk:SoaS Blueberry Instructions#Using boot helper disk with blueberry usb on intel mac|these instructions]].
  
*For a Persistent USB see this link:[http://wiki.sugarlabs.org/go/Talk:SoaS_Blueberry_Instructions]
+
==== Mac Bugs ====
 +
''The boot sequence does not work properly due to minor bugs. Follow these workarounds to boot an intel Mac''<br>''Note: to the child it is named SUGAR.  But the stick they take home is named FEDORA.''<!-- How do you file style bugs?
 +
    bugs.sugarlabs.org will take task and enhancement requests in addition to defect reports.
 +
Forcing users to rename their USB sticks something esoteric like FEDORA is just wrong -->
 +
<br><br>
 +
<!--I'd prefer something more legible than white text on white background when entering secret codes. -->
 +
*BootHelperCD cannot boot Mac without typing secret code into difficult to read window:<br> ''for complete details [[ Talk:SoaS_Blueberry_Instructions#Using_boot_helper_disk_with_blueberry_usb_on_intel_mac | click here ]]''
 +
<!--See the end of this discussion, http://answers.edge.launchpad.net/soas/+question/95622.  It provides a way to edit the boot kernel arguments to boot on a Mac.  You may be able to advance the instructions from there. -->
 +
** press the tab key to interrupt the boot sequence.
 +
** append selinux=0 to the kernel's list of boot parameters.
 +
** press return or enter to continue the boot process.
 +
Submit bugs to request a different flavor of boot helper CD  that boots Mac automatically, without typing selinux=0 and removes the countdown, Macs innately have the option key interrupt, the mouse down interrupt and the power button interrupt to handle this boot time issue.
 +
<br>
 +
*BootHelperCD will not boot sticks created by a Mac:
 +
** BootHelperCD can only boot sticks named FEDORA.
 +
** Image-writer-mac writes the name blueberry-2-soas onto the stick.
 +
** USB stick is created as read only. So the name is not easily changed by mere mortals.
 +
This is a showstopper.<br>You cannot boot without hacking the USB stick name.<br>Use windows instructions to create Sugar on a Stick, named FEDORA, with persistent overlay.
 +
<br>
 +
*Sugar on a Stick is READ-ONLY when created by a Mac:
 +
**Nothing is saved between reboots. Sugar asks for your name and colors each boot.
 +
**image-writer-mac does not create a persistent overlay file.
 +
There is no way to create a persistent overlay on Mac without hacking the USB stick.<br>Use windows instructions to create Sugar on a Stick, named FEDORA, with persistent overlay.
  
=== 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.
+
====Older Mac with powerPC processor====
 +
Sugar on a Stick Blueberry and Strawberry images are for the Intel processor. <br>
 +
Mac computers with powerPC processors will need a different flavor image to run.
 +
*It is possible to download Blueberry and Strawberry images and flash them onto usb drives with a powerPC Mac.
 +
*It is also possible to develop Sugar Activities with a powerPC Mac.
 +
*The use of powerPC Mac as a School Server has not been tested.
  
[[Image:image-writer-mac.png|left|200px]]
+
 +
Fedora Core is available for the powerPC processor. By booting Fedora on your Mac, you change it into a Fedora machine. You may then install Sugar directly onto the hard drive.  The use of intel processor emulation on powerPC Mac is not recommended. Due to the aging speeds of powerPC Macs, installing Fedora and Sugar will drastically outperform emulation.
  
* Download the '''Sugar on a Stick v2 Blueberry''' live image from here: http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso
+
See the Linux section for more details.
* Download the '''image-writer''' tool for Macs from here: http://download.sugarlabs.org/soas/releases/image-writer-mac
+
<br><br><br><!-- template does not allow enough separation between disparate sections-->
* 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.
 

Latest revision as of 20:50, 30 June 2012


For Windows Users

Persons using PCs running Windows have two options for creating a Sugar/Blueberry USB flash drive:

Option #1: Use LiveUSB Creator from within Windows to create a Sugar-on-a-Stick Live USB with a compressed filesystem.
Fedora-liveusb-creator.png
  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 (1GB 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.
Option #2: (ADVANCED USERS ONLY) Create a bootable Sugar/Blueberry USB flash drive that does not have a compressed filesystem. This option requires at least a 4GB drive.
WARNING: MAKING A MISTAKE IN THIS PROCEDURE COULD WIPE YOUR PC'S HARD DISK!!!!
  1. In Windows, download the latest version of the Live CD image, and burn the image to a CD.
  2. Follow the instructions here to create the bootable Sugar/Blueberry USB flash drive by (i) booting the PC into Sugar with the CD and (ii) running ZyX-LiveInstaller within the Terminal activity. You will also need a spare, blank (or erasable) USB flash drive -- preferably manufactured by a different manufacturer than the target USB -- to use as a swap drive during the procedure. Any data on the swap drive will be wiped.

Notes:

  • If you do Option #1 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.
  • Option #1 creates an SoaS that cannot detect when its drive space eventually runs out, causing stick failure.
  • Option #2 creates a more-robust, more-stable drive whose free space can be monitored using the Terminal activity. Non-compressed SoaS drives, however, are not bootable with a boot helper CD.

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
8022b68433295f12fbfffa66bf49205851a6a1e0 
  • 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.

3. zyx-liveinstaller: Sugar on a Stick/ZyX-LiveInstaller

4. Instructions for installing with persistent storage for Blueberry: Talk:SoaS Blueberry Instructions. See also Sugar on a Stick/Linux.

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.

If your boot hangs, you may need to modify the boot command by appending:

selinux=0

You do this by interrupting the Helper CD boot by hitting the Esc key once the initial splash-screen appears. You should see a list of four boot options. At this point, hit the Tab key. The command line should appear. Add selinix=0 to the end of the line and hit Return (or Enter). The boot should proceed from here as normal.

For Mac OS X Users

Question.png
NOTE to Instruction Editors:
Please test and adjust instructions for the soon-to-be-released Sugar on a Stick/Mirabelle. Draft instructions at Sugar on a Stick/Beta.

Sugar on a Stick Blueberry and Strawberry images are for the Intel processor.
See Using Sugar with powerPC if you do not have an Intel processor.

To identify the Mac's processor and OS X version

Choose Apple menu > About This Mac. A small window will appear titled About This Mac. The processor type should be in the window.

To download Sugar on a Stick

For protection against tampering and transmission errors, always compare the checksum of each download.

To calculate a file's SHA-1 checksum

Open the Terminal Utility and type into the Terminal Window. Press the return key to run the command.

  • Mac OS version ≥10.6
    shasum ~/Downloads/soas-2-blueberry.iso
  • Mac OS version ≤10.5
    openssl sha1 ~/Downloads/soas-2-blueberry.iso
  • Compare the result to the official SHA-1 checksum stored at Sugar Labs.


To install Sugar onto a Stick

  • Download the image-writer for Mac
    PythonLauncher may automatically open the file; don't allow that, just download it.
  • Verify the file was downloaded properly by calculating its SHA-1 checksum
    For protection against tampering and transmission errors, always compare the checksum of each download.
  • Eject all USB drives. Insert the flash drive you wish to install Sugar on a Stick.
    WARNING: your entire flash drive will be overwritten in the next step! All partitions will be erased.
  • Open the Terminal Utility and type into the Terminal Window. Press the return key to run the command.
    cd ~/Downloads; python image-writer-mac.py soas-2-blueberry.iso


Image-writer-mac.png


To create a Boot Helper CD

  • Download the USB boot helper soas-2-boot.iso
  • Verify the file was downloaded properly by calculating its SHA-1 checksum
    For protection against tampering and transmission errors, always compare the checksum of each download.
  • Open the Disk Utility. Drag the downloaded soas-2-boot.iso to the bottom of the list.
  • Select the Disc Image in the list, then press the Burn button.
  • Insert a blank disc when prompted.


To boot Sugar on a Stick

  • insert the USB drive loaded with Blueberry flavor Sugar on a Stick.
  • insert the Boot Helper CD.
  • Press the Power Button on the intel Mac. If a dialog box appears, press the Restart Button.
  • During the startup sound, press and hold the letter C.
    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.

Suggestion:

Using a boot helper disc may fix the bugs listed below. See these instructions.

Mac Bugs

The boot sequence does not work properly due to minor bugs. Follow these workarounds to boot an intel Mac
Note: to the child it is named SUGAR. But the stick they take home is named FEDORA.

  • BootHelperCD cannot boot Mac without typing secret code into difficult to read window:
    for complete details click here
    • press the tab key to interrupt the boot sequence.
    • append selinux=0 to the kernel's list of boot parameters.
    • press return or enter to continue the boot process.
Submit bugs to request a different flavor of boot helper CD  that boots Mac automatically, without typing selinux=0 and removes the countdown, Macs innately have the option key interrupt, the mouse down interrupt and the power button interrupt to handle this boot time issue.


  • BootHelperCD will not boot sticks created by a Mac:
    • BootHelperCD can only boot sticks named FEDORA.
    • Image-writer-mac writes the name blueberry-2-soas onto the stick.
    • USB stick is created as read only. So the name is not easily changed by mere mortals.
This is a showstopper.
You cannot boot without hacking the USB stick name.
Use windows instructions to create Sugar on a Stick, named FEDORA, with persistent overlay.


  • Sugar on a Stick is READ-ONLY when created by a Mac:
    • Nothing is saved between reboots. Sugar asks for your name and colors each boot.
    • image-writer-mac does not create a persistent overlay file.
There is no way to create a persistent overlay on Mac without hacking the USB stick.
Use windows instructions to create Sugar on a Stick, named FEDORA, with persistent overlay.


Older Mac with powerPC processor

Sugar on a Stick Blueberry and Strawberry images are for the Intel processor.
Mac computers with powerPC processors will need a different flavor image to run.

  • It is possible to download Blueberry and Strawberry images and flash them onto usb drives with a powerPC Mac.
  • It is also possible to develop Sugar Activities with a powerPC Mac.
  • The use of powerPC Mac as a School Server has not been tested.


Fedora Core is available for the powerPC processor. By booting Fedora on your Mac, you change it into a Fedora machine. You may then install Sugar directly onto the hard drive. The use of intel processor emulation on powerPC Mac is not recommended. Due to the aging speeds of powerPC Macs, installing Fedora and Sugar will drastically outperform emulation.

See the Linux section for more details.