Difference between revisions of "Sugar on a Stick/Strawberry"

From Sugar Labs
Jump to navigation Jump to search
m (update Macintosh link)
 
(60 intermediate revisions by 12 users not shown)
Line 1: Line 1:
[[Image:SugarLabs3x.jpg|right]]
+
<noinclude>{{TeamHeader|Sugar on a Stick|home=Project Home|xbgColor=ffe792|join_label=Get Involved}}
 +
[[Category:Live USB]]
 +
</noinclude>
 +
<div style="font-size: smaller" align="right">released 22 June 2009</div>
 +
[[File:SugarLabs3x.jpg|right|a Sugar environment you can carry in your pocket!|link=http://download.sugarlabs.org/soas/releases/soas-1-strawberry.iso]]
 +
[[File:Logo_SoaS_01.png|200px|link=http://download.sugarlabs.org/soas/releases/soas-1-strawberry.iso]][http://download.sugarlabs.org/soas/releases/soas-1-strawberry.iso Strawberry]
  
 
== Sugar on a Stick - Strawberry ==
 
== Sugar on a Stick - Strawberry ==
 +
: ''a Sugar environment you can carry in your pocket''
  
'''Release Notes - last update: 2009/06/23'''
+
{{Note/note||Sugar on a Stick v1 '''Strawberry''' has been superseded by the [[Sugar_on_a_Stick/Blueberry|v2 Blueberry release]] as of 8 December 2009. See [[Sugar on a Stick/Downloads]] for the current release.}}
  
This document provides instructions for preparing a Sugar on a Stick (SoaS) installation. It also contains a list of known issues and sources of further information. For more detailed information, please check the [[Sugar_on_a_Stick|SoaS wiki page]].
+
Release Notes - last software update: 24 June 2009
  
The Sugar on a Stick Strawberry release is based Fedora 11 and includes the latest updates as of June 22. It also features the last Sugar desktop environment, namely [[DevelopmentTeam/Release/Releases/Sucrose/0.84| version 0.84]], and additional activities to enrich the user experience. Interested users can download further activities from the [http://activities.sugarlabs.org/ Sugar Activity Library]. This release is step forward from the [[Sugar_on_a_Stick/Beta| beta release]]; in addition to Fedora updates, it includes supplementary sample content, which is available in the Journal. Apart from the default [[Sugar_on_a_Stick/Roadmap#Fructose_modules_.28F11.29|fructose]] activities, additional activities are included in this release.
+
This document provides instructions for preparing a Sugar on a Stick (SoaS) installation. It also contains a list of known issues and sources of further information, for example how to use a Boot Helper CD for very old PCs. For more detailed information, please check the [[Sugar_on_a_Stick|SoaS wiki page]]. For more general information, please see the [[Sugar on a Stick/FAQ|Frequently Asked Questions (FAQ) page for Sugar on a Stick]].
 +
 
 +
The Sugar on a Stick Strawberry release is based on Fedora 11 with the latest updates as of June 22. It also features a recent Sugar learning environment, namely [[0.84/Notes| version 0.84]], including 40 Activities to enrich the learning experience. Hundreds of Activities are available for download from the [http://activities.sugarlabs.org/ Sugar Activity Library]. This release includes Fedora updates, new Sugar features like ''View Source'' and file transfer, supplementary sample content, which is available in the Journal, and usability improvements. Apart from the default [[Sugar_on_a_Stick/Roadmap#Fructose_modules_.28F11.29|Fructose]] activities, the following table of additional Activities are included in this release. (See the Sugar [[Taxonomy]] for an explanation of these codenames.)
 +
__TOC__
  
 
{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: #e3e4e5;"
 
{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: #e3e4e5;"
 
|-style="background:#787878; color: white;"
 
|-style="background:#787878; color: white;"
| '''Fructose Activity''' || || '''Honey Activity''' || '''Honey Activity'''
+
| '''Fructose Activity''' || '''Honey Activity''' || '''Honey Activity'''
 
|-
 
|-
| [http://activities.sugarlabs.org/en-US/sugar/addon/4024 Browse] || || [http://activities.sugarlabs.org/en-US/sugar/addon/4037 CartoonBuilder] || [http://activties.sugarlabs.org/en-US/sugar/addon/4063 Memorize]
+
| [http://activities.sugarlabs.org/en-US/sugar/addon/4024 Browse] || [http://activities.sugarlabs.org/en-US/sugar/addon/4037 CartoonBuilder] || [http://activities.sugarlabs.org/en-US/sugar/addon/4063 Memorize]
 
|-
 
|-
| [http://activities.sugarlabs.org/en-US/sugar/addon/4076 Calculate] || || [http://activities.sugarlabs.org/en-US/sugar/addon/4050 Colors] || [http://activities.sugarlabs.org/en-US/sugar/addon/4034 Moon]
+
| [http://activities.sugarlabs.org/en-US/sugar/addon/4076 Calculate] || [http://activities.sugarlabs.org/en-US/sugar/addon/4050 Colors] || [http://activities.sugarlabs.org/en-US/sugar/addon/4034 Moon]
 
|-
 
|-
| [http://activities.sugarlabs.org/en-US/sugar/addon/4069 Chat] || || [http://activities.sugarlabs.org/en-US/sugar/addon/4044 FlipSticks] || [http://activities.sugarlabs.org/en-US/sugar/addon/4082 Paint]
+
| [http://activities.sugarlabs.org/en-US/sugar/addon/4069 Chat] || [http://activities.sugarlabs.org/en-US/sugar/addon/4044 FlipSticks] || [http://activities.sugarlabs.org/en-US/sugar/addon/4082 Paint]
 
|-
 
|-
| [http://activities.sugarlabs.org/en-US/sugar/addon/4030 Etoys] || || [http://activities.sugarlabs.org/en-US/sugar/addon/4054 FreeCell] || [http://activities.sugarlabs.org/en-US/sugar/addon/4193 Physics]
+
| [http://activities.sugarlabs.org/en-US/sugar/addon/4030 Etoys] || [http://activities.sugarlabs.org/en-US/sugar/addon/4054 FreeCell] || [http://activities.sugarlabs.org/en-US/sugar/addon/4193 Physics]
 
|-
 
|-
| [http://activities.sugarlabs.org/en-US/sugar/addon/4032 Image Viewer] || || [http://activities.sugarlabs.org/en-US/sugar/addon/4042 InfoSlicer] || [http://activities.sugarlabs.org/en-US/sugar/addon/4074 Poll]
+
| [http://activities.sugarlabs.org/en-US/sugar/addon/4032 Image Viewer] || [http://activities.sugarlabs.org/en-US/sugar/addon/4042 InfoSlicer] || [http://activities.sugarlabs.org/en-US/sugar/addon/4074 Poll]
 
|-
 
|-
| [http://activities.sugarlabs.org/en-US/sugar/addon/4045 Jukebox] || || [http://activities.sugarlabs.org/en-US/sugar/addon/4029 IRC] || [http://activities.sugarlabs.org/en-US/sugar/addon/4081 Record]
+
| [http://activities.sugarlabs.org/en-US/sugar/addon/4045 Jukebox] || [http://activities.sugarlabs.org/en-US/sugar/addon/4029 IRC] || [http://activities.sugarlabs.org/en-US/sugar/addon/4081 Record]
 
|-
 
|-
| [http://activities.sugarlabs.org/en-US/sugar/addon/4056 Log] || || [http://activities.sugarlabs.org/en-US/sugar/addon/4046 JigsawPuzzle] || [http://activities.sugarlabs.org/en-US/sugar/addon/4047 SliderPuzzle]
+
| [http://activities.sugarlabs.org/en-US/sugar/addon/4056 Log] || [http://activities.sugarlabs.org/en-US/sugar/addon/4046 JigsawPuzzle] || [http://activities.sugarlabs.org/en-US/sugar/addon/4047 SliderPuzzle]
 
|-
 
|-
| [http://activities.sugarlabs.org/en-US/sugar/addon/4041 Pippy] || || [http://activities.sugarlabs.org/en-US/sugar/addon/4064 JokeMachine] || [http://activities.sugarlabs.org/en-US/sugar/addon/4038 Speak]
+
| [http://activities.sugarlabs.org/en-US/sugar/addon/4041 Pippy] || [http://activities.sugarlabs.org/en-US/sugar/addon/4064 JokeMachine] || [http://activities.sugarlabs.org/en-US/sugar/addon/4038 Speak]
 
|-
 
|-
| [http://activities.sugarlabs.org/en-US/sugar/addon/4028 Read] || || [http://activities.sugarlabs.org/en-US/sugar/addon/4078 Labyrinth] || [http://activities.sugarlabs.org/en-US/sugar/addon/4073 StoryBuilder]  
+
| [http://activities.sugarlabs.org/en-US/sugar/addon/4028 Read] || [http://activities.sugarlabs.org/en-US/sugar/addon/4078 Labyrinth] || [http://activities.sugarlabs.org/en-US/sugar/addon/4073 StoryBuilder]  
 
|-
 
|-
| [http://activities.sugarlabs.org/en-US/sugar/addon/4043 Terminal] || || [http://activities.sugarlabs.org/en-US/sugar/addon/4089 Library] || [http://activities.sugarlabs.org/en-US/sugar/addon/4039 ViewSlides]
+
| [http://activities.sugarlabs.org/en-US/sugar/addon/4043 Terminal] || [http://activities.sugarlabs.org/en-US/sugar/addon/4089 Library] || [http://activities.sugarlabs.org/en-US/sugar/addon/4039 ViewSlides]
 
|-
 
|-
| [http://activities.sugarlabs.org/en-US/sugar/addon/4027 Turtle Art] || || ||
+
| [http://activities.sugarlabs.org/en-US/sugar/addon/4027 Turtle Art] || ||
 
|-
 
|-
| Write  || ||  ||
+
| [http://activities.sugarlabs.org/en-US/sugar/addon/4201 Write] ||  ||
 
|}
 
|}
 
  
 
=== Get it! ===
 
=== Get it! ===
 
+
{{Transclude|Sugar on a Stick/Downloads}}
 
==== Windows Users ====
 
==== Windows Users ====
  
# Download the latest version of Fedora ''LiveUSB Creator'' from https://fedorahosted.org/liveusb-creator/ and extract it;
+
# Download the latest version of Fedora ''LiveUSB Creator'' from http://fedorahosted.org/liveusb-creator/ and extract it;
# Plug a target USB key into your computer (minimum 1-gigabyte);
+
# Plug a target USB flash drive into your computer (minimum 1-gigabyte);
# Use the ''Format'' dialog to rename your USB ''Volume'' to FEDORA;
+
# Launch ''LiveUSB Creator'';
# Launch''LiveUSB Creator'';
+
# Select ''Sugar on a Stick (Strawberry)'' in the drop-down menu on the upper-right side of the ''LiveUSB Creator'' window;
# Select ''Sugar on a Stick v1 Strawberry'' in the drop-down menu on the upper-right side of the ''LiveUSB Creator'' window;
+
# Set the ''Persistent Storage'' slider to the maximum so you can save your Sugar work onto the USB device;
# Set the ''Persistent Storage'' slider to at least 160 MB (use more if you have a key with more space);
+
#:(You may allocate as much storage as there is capacity on your device.  You may allocate less than the maximum, if you want to use some of the device storage when not booting Sugar.)
# Select your USB key as the target;
+
#: If you repeat this installation on a device after having saved some Sugar work or changes, all Sugar work and changes will be lost.
# Click the ''Create Live USB'' button and then wait for the process to finish (about 5 minutes);
+
# Select your USB flash drive as the target;
# Eject the USB key using the ''Safely Remove Hardware'' dialog.
+
# Click the ''Create Live USB'' button and then wait for the process to finish (the time required will depend mostly on your download speed);
 +
# Close the ''LiveUSB Creator'' program;
 +
# When ejecting the USB flash drive from the computer, first stop the device with the ''Safely Remove Hardware'' dialog.
 +
: More information is available [[Sugar on a Stick/Windows|here]].
  
==== Linux Users ====
+
==== GNU/Linux Users ====
  
# Download the SoaS iso image from http://download.sugarlabs.org/soas/releases/soas-strawberry.iso
+
# Download the SoaS iso image from {{SoaS release path}},
# Install these three packages: ''syslinux'', ''isomd5sum'', and ''cryptsetup''
+
# Install these three packages: ''syslinux'', ''isomd5sum'', and ''cryptsetup'' ([[Sugar_on_a_Stick/Linux#Put_SoaS_onto_a_stick_using_Fedora_and_Ubuntu|details here]]), 
 
# Download this script: http://download.sugarlabs.org/soas/releases/livecd-iso-to-disk.sh
 
# Download this script: http://download.sugarlabs.org/soas/releases/livecd-iso-to-disk.sh
# Plug your target USB key into your computer;
+
# Change mode to make the script executable,
# Unmount the USB key (e.g., <code>sudo umount /dev/sdb1</code>);
+
#: <code>chmod +x livecd-iso-to-disk.sh</code>
 +
# Plug your target USB flash drive into your computer,
 +
# Unmount the USB flash drive (e.g., <code>sudo umount /dev/sdb1</code>),
 
# Execute the script with the following command:
 
# Execute the script with the following command:
:<code>sudo ./livecd-iso-to-disk.sh --overlay-size-mb 300 --home-size-mb 160 --delete-home --unencrypted-home soas-strawberry.iso /dev/sdb1</code>
+
#:<code>sudo ./livecd-iso-to-disk.sh --overlay-size-mb 300 --home-size-mb 160 --delete-home --unencrypted-home soas-1-strawberry.iso /dev/sdb1</code>
  
:'''Note:''' In this example, your USB device would be sdb1! Adjust this before confirming the command, if necessary. Also, you might want to increase the home or overlay size if you have more than 1 GB of space.
+
:'''Note:''' In this example, your USB device node is assumed to be sdb. Verify this before confirming the command. Also, you might want to increase the home or overlay size if you have more than 1 GB of space.
 +
: More detailed information is available [[Sugar on a Stick/Linux|here]].
  
 
==== Mac Users ====
 
==== Mac Users ====
  
* Mac users will need to have access to a Linux or Windows machine to prepare their USB key
+
Apple Macintosh users will need to have access to a GNU/Linux or Windows machine to prepare their USB flash drive.
* Create your SoaS as described above for the different systems
+
# Create your SoaS as described above;
* Download the boot helper disk: http://download.sugarlabs.org/soas/releases/soas-boot.iso
+
# Download the boot helper disk: http://download.sugarlabs.org/soas/releases/soas-1-boot.iso
* Put both the CD and the USB key in
+
# Put both the CD and the USB flash drive into the machine;
* Turn the Mac on and press at the chime the "C" key
+
# Turn the Mac on and press at the chime the "C" key;
* It should boot from the CD and continue to use the USB key then
+
# It should boot from the CD and continue to use the USB flash drive from this point.
 +
:'''Note:''' This is an experimental method to run SoaS on a Mac. Not all hardware configurations might be supported, as it is also noted in the [[#Known Issues]] section below. If you run into issues, you might want to consider using a virtual machine. See [[#XO-1 & Virtual Machines]] section below.
 +
: More information is available [[Macintosh|here]].
  
'''Note:''' This is an experimental method to run SoaS on a Mac. Not all hardware configurations might be supported, as it is also noted in the known issues section. If you run into issues, you might want to consider using a virtual machine.
+
==== XO-1 & Virtual Machines ====
  
=== Boot it! ===
+
The use of SoaS on the OLPC XO-1, as well as in virtual machines, is currently in an experimental state. Instructions for both categories are being developed here for '''[[Sugar on a Stick/Installation/OLPC|XO-1]]''', '''[[VirtualBox]]''', & '''[[VMware#Soas-Strawberry.iso_installed_to_VM_Hard_Disk|VMware]]'''. In the meantime, you might want to refer to the information on the general SoaS [[Sugar_on_a_Stick| wiki page]].
  
* Set the option to boot from USB in your machine's BIOS and let it come up
+
=== Boot it ===
* If your machine doesn't support that, download and burn: http://download.sugarlabs.org/soas/releases/soas-boot.iso
 
* Make sure to name your USB key FEDORA, as it won't be recognized otherwise
 
* Put both the CD and the USB key in and let it boot from CD
 
  
=== Use it! ===
+
# Insert the USB drive into a USB port on your computer. Ports directly connected to the motherboard (usually on the back of the computer) are more likely to recognize the device at boot time.
 +
# Set the option to boot from USB in your machine's BIOS and then start up the computer. This can be done in a number of ways and will VARY from machine to machine. What you are looking for is the term "Boot Loader" or "Boot Order" or something to that effect. You may have to play around with the settings quite a bit to achieve success. The BIOS in not a graphical user interface. Your mouse will not work, generally, in the BIOS. Use the arrow keys. Read the help lines for each BIOS option. If you've not gone into the BIOS before, don't be afraid, you can't do too much damage there if you pay attention.
 +
#: Here's a video of the BIOS on my [http://www.youtube.com/watch?v=2UJbtY67VYQ compac tc4400].
 +
# You should see the Sugar logo if the drive is booting. Proceed to the '''Use it''' section.
  
You have successfully installed Sugar on a Stick - now you can explore it. If you are interested in a guide for Sugar, you might want to check this: http://en.flossmanuals.net/sugar
+
==== Helper CD ====
 +
If your machine doesn't support booting from USB devices, then download the following soas-1-boot.iso and burn it to a CD.
 +
* [http://www.imgburn.com/ ImgBurn] and [http://www.dvdflick.net/download.php DVD flick] are some freeware, .iso burning tools for Windows.
 +
 
 +
Download the boot support helper CD image at http://download.sugarlabs.org/soas/releases/soas-1-boot.iso.
 +
# Use [[wikipedia:Windows Explorer|Windows Explorer]] to name your USB flash drive FEDORA (from the Properties dialog for your device), otherwise it won't be recognized by the boot-support CD.
 +
# Put both the boot-support CD and the USB flash drive in your computer and let it boot from the CD.
 +
 
 +
=== Use it ===
 +
 
 +
* Once you have successfully launched Sugar on a Stick, you should explore the Sugar Learning Platform. There is a [http://en.flossmanuals.net/sugar guide to Sugar] with help pages dedicated to most activities.
 +
* Do try running Sugar on more than one machine, so you can enjoy its collaboration features.
 +
* Sugar on a Stick uses by default the ''English (USA)'' keyboard layout.
 +
*: If you need to change this, you need to use the Terminal activity.
 +
*:: Terminal is not in the default Home View ring (Favorite activities), to reach it,
 +
*::# Switch to 'List view' (the far right switch button on the Home View toolbar),
 +
*::# Find the Terminal Activity (more than half-way down in the list, or use the Search box on the left of the toolbar),
 +
*:# Click on the Terminal icon to launch the activity,
 +
*:# Enter <code>system-config-keyboard</code> at the command-line prompt and press the <Enter> key,
 +
*:# Select your keyboard choice in the new window that appears and click the 'OK' button.
  
 
== Help Us ==
 
== Help Us ==
  
Please share your feedback with us - it helps us to improve following versions of SoaS. You can always send an e-mail to our feedback address [mailto:feedback@sugarlabs.org feedback@sugarlabs.org] or join the ''<nowiki>It's an Education Project</nowiki>'' mailing list: http://lists.sugarlabs.org/listinfo/iaep
+
Please share your feedback with us; it will help us to improve Sugar in subsequent versions of SoaS. Join the ''Sugar on a Stick (SoaS)'' mailing list: http://lists.sugarlabs.org/listinfo/soas, or you can always join the ''It's an Education Project'' mailing list: http://lists.sugarlabs.org/listinfo/iaep.  See all our [[Sugar Labs/Communication channels|'''communication channels''']] and our [[Sugar Labs/Getting Involved|'''Getting Involved''']] pages.
  
If you encounter any hardware related issues besides the ones listed below, please consider joining our [[Sugar_on_a_Stick/Hardware| hardware effort]]. There, you will be able to submit the specs of your hardware, so that we can look better into it and work together with upstream to resolve issues.
+
If you encounter any hardware-related issues besides the ones [[#Known Issues|listed below]], please consider joining our [[Sugar_on_a_Stick/Hardware| hardware effort]]. Please submit the specifications of your hardware so that we work together with 'upstream' to resolve any issues.
  
Finally, you might also submit a bug report at our [http://dev.sugarlabs.org/ bug tracker], for which you would need an account.
+
Finally, you might also consider submitting bug reports at our [https://bugs.sugarlabs.org bug tracker] (you would need to create an account).
  
 
=== Known Issues ===
 
=== Known Issues ===
Line 99: Line 134:
 
Sugar on a Stick Strawberry is based on [http://www.fedoraproject.org/ Fedora 11], the latest release. Consequently, it contains a number of known issues with Fedora images that should be mentioned.
 
Sugar on a Stick Strawberry is based on [http://www.fedoraproject.org/ Fedora 11], the latest release. Consequently, it contains a number of known issues with Fedora images that should be mentioned.
 
* Recently, problems with ATI graphics hardware, as well as various Mac models have been reported. This was resolved by adding the ''nomodeset'' parameter to the kernel arguments.
 
* Recently, problems with ATI graphics hardware, as well as various Mac models have been reported. This was resolved by adding the ''nomodeset'' parameter to the kernel arguments.
* If you encounter image flickering or are not able to get past a black screen, it might be worth pressing escape at the blue screen, which appears for a second before the normal boot process starts. You'll be presented a short menu, at which you can directly press tab - just add the ''nomodeset'' argument then in the appearing line and boot with enter.  
+
* If you encounter image flickering or are not able to get past a black screen, it might be worth pressing the <Escape> key at the blue screen, which appears for a second before the normal boot process starts. You'll be presented a short menu, at which you can directly press tab, then just add the ''nomodeset'' argument in the appearing line, and then boot by pressing the <Enter> key.  
For more information, please refer to the [https://fedoraproject.org/wiki/Common_F11_bugs#Hardware-related_issues list of common F11 bugs].
+
For more information, please refer to the [http://fedoraproject.org/wiki/Common_F11_bugs#Hardware-related_issues list of common F11 bugs].
 
+
=== Beta Builds ===
 +
Developers and testers can help us debug the next version. See [[Sugar on a Stick/Beta]].
 
=== Custom Builds ===
 
=== Custom Builds ===
  
Instructions how to customize and compose an image will be provided here shortly.
+
Preliminary instructions how to customize and compose an image can be found [[Sugar_on_a_Stick/Customization| here]].

Latest revision as of 19:46, 30 June 2012

Project Home   ·   Get Involved   ·   Contacts   ·   Resources   ·   FAQ   ·   Roadmap   ·   To Do   ·   Meetings

released 22 June 2009
a Sugar environment you can carry in your pocket!

Logo SoaS 01.pngStrawberry

Sugar on a Stick - Strawberry

a Sugar environment you can carry in your pocket
35px-Activity-write.png
Sugar on a Stick v1 Strawberry has been superseded by the v2 Blueberry release as of 8 December 2009. See Sugar on a Stick/Downloads for the current release.

Release Notes - last software update: 24 June 2009

This document provides instructions for preparing a Sugar on a Stick (SoaS) installation. It also contains a list of known issues and sources of further information, for example how to use a Boot Helper CD for very old PCs. For more detailed information, please check the SoaS wiki page. For more general information, please see the Frequently Asked Questions (FAQ) page for Sugar on a Stick.

The Sugar on a Stick Strawberry release is based on Fedora 11 with the latest updates as of June 22. It also features a recent Sugar learning environment, namely version 0.84, including 40 Activities to enrich the learning experience. Hundreds of Activities are available for download from the Sugar Activity Library. This release includes Fedora updates, new Sugar features like View Source and file transfer, supplementary sample content, which is available in the Journal, and usability improvements. Apart from the default Fructose activities, the following table of additional Activities are included in this release. (See the Sugar Taxonomy for an explanation of these codenames.)

Fructose Activity Honey Activity Honey Activity
Browse CartoonBuilder Memorize
Calculate Colors Moon
Chat FlipSticks Paint
Etoys FreeCell Physics
Image Viewer InfoSlicer Poll
Jukebox IRC Record
Log JigsawPuzzle SliderPuzzle
Pippy JokeMachine Speak
Read Labyrinth StoryBuilder
Terminal Library ViewSlides
Turtle Art
Write

Get it!

Note: The contents of this section have been transcluded from another page, Sugar on a Stick/Downloads:

Sugar on a Stick/Downloads

SugaronastickAvocado-320px.png
Sugar on a Stick is a Fedora® Spin operating system featuring the award-winning Sugar Learning Platform.

Sugar on a Stick will run on

  • any 64-bit Notebook, Laptop, or Desktop computer, with a minimum of 1GB RAM, that can run Linux, Windows or macOS, using a USB thumbdrive or stick, as a Live USB,
  • a 32-bit computer with the TOAST version of Sugar (Trisquel on a Sugar Toast). See Trisquel On A Sugar Toast.
  • a Raspberry Pi 2 or 3, using a microSD card, or;
  • any computer as a virtual machine.

You can use Sugar on a Stick to demo Sugar almost anywhere without disturbing the contents of the computer you use, and if people like what they see, you can install Sugar on a Stick to their hard drives or other sticks from the demo stick.

Download Mirabell.png

x86_64 (64-bit)

Download Mirabell.png armhfp Raspberry Pi 2 or 3, see How to install.


Fedora and the Infinity design logo are trademarks of Red Hat, Inc.

Windows Users

  1. Download the latest version of Fedora LiveUSB Creator from http://fedorahosted.org/liveusb-creator/ and extract it;
  2. Plug a target USB flash drive into your computer (minimum 1-gigabyte);
  3. Launch LiveUSB Creator;
  4. Select Sugar on a Stick (Strawberry) in the drop-down menu on the upper-right side of the LiveUSB Creator window;
  5. Set the Persistent Storage slider to the maximum so you can save your Sugar work onto the USB device;
    (You may allocate as much storage as there is capacity on your device. You may allocate less than the maximum, if you want to use some of the device storage when not booting Sugar.)
    If you repeat this installation on a device after having saved some Sugar work or changes, all Sugar work and changes will be lost.
  6. Select your USB flash drive as the target;
  7. Click the Create Live USB button and then wait for the process to finish (the time required will depend mostly on your download speed);
  8. Close the LiveUSB Creator program;
  9. When ejecting the USB flash drive from the computer, first stop the device with the Safely Remove Hardware dialog.
More information is available here.

GNU/Linux Users

  1. Download the SoaS iso image from http://download.sugarlabs.org/soas/releases/soas-1-strawberry.iso,
  2. Install these three packages: syslinux, isomd5sum, and cryptsetup (details here),
  3. Download this script: http://download.sugarlabs.org/soas/releases/livecd-iso-to-disk.sh
  4. Change mode to make the script executable,
    chmod +x livecd-iso-to-disk.sh
  5. Plug your target USB flash drive into your computer,
  6. Unmount the USB flash drive (e.g., sudo umount /dev/sdb1),
  7. Execute the script with the following command:
    sudo ./livecd-iso-to-disk.sh --overlay-size-mb 300 --home-size-mb 160 --delete-home --unencrypted-home soas-1-strawberry.iso /dev/sdb1
Note: In this example, your USB device node is assumed to be sdb. Verify this before confirming the command. Also, you might want to increase the home or overlay size if you have more than 1 GB of space.
More detailed information is available here.

Mac Users

Apple Macintosh users will need to have access to a GNU/Linux or Windows machine to prepare their USB flash drive.

  1. Create your SoaS as described above;
  2. Download the boot helper disk: http://download.sugarlabs.org/soas/releases/soas-1-boot.iso
  3. Put both the CD and the USB flash drive into the machine;
  4. Turn the Mac on and press at the chime the "C" key;
  5. It should boot from the CD and continue to use the USB flash drive from this point.
Note: This is an experimental method to run SoaS on a Mac. Not all hardware configurations might be supported, as it is also noted in the #Known Issues section below. If you run into issues, you might want to consider using a virtual machine. See #XO-1 & Virtual Machines section below.
More information is available here.

XO-1 & Virtual Machines

The use of SoaS on the OLPC XO-1, as well as in virtual machines, is currently in an experimental state. Instructions for both categories are being developed here for XO-1, VirtualBox, & VMware. In the meantime, you might want to refer to the information on the general SoaS wiki page.

Boot it

  1. Insert the USB drive into a USB port on your computer. Ports directly connected to the motherboard (usually on the back of the computer) are more likely to recognize the device at boot time.
  2. Set the option to boot from USB in your machine's BIOS and then start up the computer. This can be done in a number of ways and will VARY from machine to machine. What you are looking for is the term "Boot Loader" or "Boot Order" or something to that effect. You may have to play around with the settings quite a bit to achieve success. The BIOS in not a graphical user interface. Your mouse will not work, generally, in the BIOS. Use the arrow keys. Read the help lines for each BIOS option. If you've not gone into the BIOS before, don't be afraid, you can't do too much damage there if you pay attention.
    Here's a video of the BIOS on my compac tc4400.
  3. You should see the Sugar logo if the drive is booting. Proceed to the Use it section.

Helper CD

If your machine doesn't support booting from USB devices, then download the following soas-1-boot.iso and burn it to a CD.

Download the boot support helper CD image at http://download.sugarlabs.org/soas/releases/soas-1-boot.iso.

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

Use it

  • Once you have successfully launched Sugar on a Stick, you should explore the Sugar Learning Platform. There is a guide to Sugar with help pages dedicated to most activities.
  • Do try running Sugar on more than one machine, so you can enjoy its collaboration features.
  • Sugar on a Stick uses by default the English (USA) keyboard layout.
    If you need to change this, you need to use the Terminal activity.
    Terminal is not in the default Home View ring (Favorite activities), to reach it,
    1. Switch to 'List view' (the far right switch button on the Home View toolbar),
    2. Find the Terminal Activity (more than half-way down in the list, or use the Search box on the left of the toolbar),
    1. Click on the Terminal icon to launch the activity,
    2. Enter system-config-keyboard at the command-line prompt and press the <Enter> key,
    3. Select your keyboard choice in the new window that appears and click the 'OK' button.

Help Us

Please share your feedback with us; it will help us to improve Sugar in subsequent versions of SoaS. Join the Sugar on a Stick (SoaS) mailing list: http://lists.sugarlabs.org/listinfo/soas, or you can always join the It's an Education Project mailing list: http://lists.sugarlabs.org/listinfo/iaep. See all our communication channels and our Getting Involved pages.

If you encounter any hardware-related issues besides the ones listed below, please consider joining our hardware effort. Please submit the specifications of your hardware so that we work together with 'upstream' to resolve any issues.

Finally, you might also consider submitting bug reports at our bug tracker (you would need to create an account).

Known Issues

Sugar on a Stick Strawberry is based on Fedora 11, the latest release. Consequently, it contains a number of known issues with Fedora images that should be mentioned.

  • Recently, problems with ATI graphics hardware, as well as various Mac models have been reported. This was resolved by adding the nomodeset parameter to the kernel arguments.
  • If you encounter image flickering or are not able to get past a black screen, it might be worth pressing the <Escape> key at the blue screen, which appears for a second before the normal boot process starts. You'll be presented a short menu, at which you can directly press tab, then just add the nomodeset argument in the appearing line, and then boot by pressing the <Enter> key.

For more information, please refer to the list of common F11 bugs.

Beta Builds

Developers and testers can help us debug the next version. See Sugar on a Stick/Beta.

Custom Builds

Preliminary instructions how to customize and compose an image can be found here.