Sugar Creation Kit

From Sugar Labs
Jump to navigation Jump to search

Sugar Creation Kit DVD

Sugar Creation Kit.png

Download Mirabell.png
Caution, this is a large file, at 3.8 GB

A complete DVD containing all the resources required to create all 3 versions of Sugar-on-a-Stick without requiring Internet access.


  • "sneakernet" or behind firewall at school.
  • save bandwidth on servers.
  • download once and distribute copies locally.


Click this^ link
  • Main sugarlabs introductory page

Get Sugar

Click this^ link
  • Main Page to Download Sugar

Chat login with list of Channels and languages

Click this^ link to enter chat
Pida ayuda a través de este canal #sugar-es Por favor, sea cortés y hacer sus preguntas.
Los voluntarios no pueden estar en línea todo el tiempo.
Sea paciente y permanecer conectado durante varios minutos para ver su respuest 
(utilizar la función de meeting para la traducción de estos artículos)
  • Ask for help on these IRC channels by clicking on either of the above links (English or Spanish)
  • NOTE: there are 4 channels on IRC: #sugar; #sugar-es; #sugar-it; #sugar-de
these channels which use MEETING to do translations between them.
to join enter this in command line of IRC: /join #sugar-it ; /join #sugar-de
Please be courteous and ask your questions.
Volunteers may not be on line all of the time. Be patient and stay connected for several minutes to see their answer.
Read the Floss Manuals first!
Most answers can be found in them

Communication channels

Click this ^ link to access a page with all the means to communicate with Sugar Labs contributors and learners. It includes mailing lists, chat rooms, blogs, forums, Jabber networks, video, mail and telephone contacts.

World Time Converter

Tiny URL


An expanded and enhanced listing of Items Included in the SugarCreationKit DVD ver 1.2.3 (see Above)
NOTE: There are newer and additional items on this web page that are not in the SCK DVD.iso

Use to Download the elements you need and burn to your own DVD to save Downloading all of the above SCK DVD.iso

Look below to the References section to see how to then convert your customized DVD to an .iso

Introduction to Sugar on a Stick

Read this first ^

Cautions with using Live USB's.pdf

How to Make a live USB.pdf:

SugaronastickMirabelle.png How to use Sugar on a Stick (SoaS)

  1. Download
  2. Install
  3. Boot
  4. Use

Burn a SoaS.iso to a CD and Boot with the resulting CD

SugaronastickMirabelle.pngTests of Nightly Composes
Click link to open ^
XO buddy.pngSoaS v5-20110415 Beta Note actually x86-64
Beta Version for testing only
XO buddy.pngSoaS v4 Mango Lassi
click link ^ for details
(The current version of Sugar on a Stick)
(Burn the .iso to a CD and Boot with the resulting CD)
  • Activities Compatible with Mango Lassi & Mirabelle
Editable Listing of Activity Compatibility Features/Soas_V4/ASLOxo Activity Test Table Please Use this wiki page to report your findings
XO buddy.pngSoaS v3 Mirabelle
Click link ^ to download
XO buddy.pngSoaS v2 Bluberry
Click link ^ to download

Spins Archives

(Burn the .iso to a CD and Boot with the resulting CD)

Hardware Compatibility

smolt profiles:

SoaS Installation variations

Click Link ^
A collection of install methods

Category:Live USB

click link ^
A collection of links on how Live USB's are used in different distributions
Commercial Source of Live SoaS Sticks
Wifi (Open FirmWare for WiFi networks):

Community Distributions

click this link^for complete listing
Linux distributions where sugar is used:
Fedora-small.jpgFedora F13 SoaS, F14 SoaS, f15-gnome3-shell and sugar0.92.0 How to install Sugar packages
Trisquel icon.pngTrisquel Tris 4.0 (Ubuntu 10.04LTS); Tris 4.5 (Ubuntu 10.10); Sugar sweets 0.88.1 or 0.90.1
Mandriva-small.pngMandriva 2010.2 Mandriva Sugar 0.88.0
Debian-small.jpgDebian Debian 6 Sugar 0.88.1
LMD-small.pngLinux Mint Debian Debian 6 Sugar 0.88.1
Caixa Mágica-small.jpgCaixa Mágica based on Mandriva 2010.1 repositories Sugar 0.88.0
Ubuntu-small.jpgUbuntu Sugar sweets 0.88.1 or 0.90.1
Suse-small.jpg openSUSE
Tuquito.pngtuquito NEW Community Distribution based on Ubuntu 10.10
Gnome icon.pngFedora 15 gnome3 with sugar 0.92.0
click this ^ link


Index of Sugar Labs Archive

  • click above link ^


  • click above link ^
  • (275.xo files and worldmap.pdf files)
New: Updated activities through 02/08/2011
  • These can be copied to a 2-GB USB device and drag-­dropped into the Sugar Journal to install them.


Etoys-116 Soasv5 RC3 Error Fix
presence-service is obsolete, but etoys still uses it and nothing else. No idea why it no longer runs.
Because PS does not find the buddy icon file. If I do
    touch ~/.sugar/default/buddy-icon.jpg
then Etoys starts fine. - Bert -
surf browser
alternate to sugar-browse
Included in latest f15 sugar 0.92.1 as the main web browser
Works in situations where sugar-browse will not start
Turtle art 107-1 rpm
for f15
Included in latest f15 sugar 0.92.1

DVD covers; artwork & screenshots

Sugarlabs mainpage 07.pngFloss Manuals

Click this link ^

(Important Manuals on how to use Sugar Applications and Features)

(Local ARCHIVE of the.pdf files shown below:)
  • Source Links:
Introduction to Sugar
MakeYourOwnSugarActivities Internet Archive Publishing Quality
In PDF, EPUB, Kindle, Daisy, Full Text. DjVu formats
MakeYourOwnSugarActivities-es with corrected index
What is Sugar
Linux Command Line
The Terminal
Turtle Art
Text to Speech:


click this link ^
(This is a site under construction)
Edward Cherlin wrote:
[IAEP] Fwd: New booki for replacing textbooks with OER 04/01/2011

Please take a look at

 a site for collaborative authoring and publishing of manuals for Open
 Source software. Sugar Labs has set up another trial instance of the
 same booki software for OER development. I am arranging for some
 further administrative changes so that we can begin to use it, and
 will then invite various interested persons and groups to try it out
 and to discuss what we might be able to do by combining this with
 Sugar and other education software.

Booki User Guide
Booki importing-a-book FLOSS Manuals WRITE Depreciated

Khan Academy videos in OGV format

click this link ^
Re: [IAEP] Khan academy content 04/05/2011
You can download around 1000 of the Khan Academy videos in OGV format
(playable on XO laptops) from   Here's an English/Spanish
index of relevant categories
If you're skeptical or haven't seen his videos, his talk sparked a great
discussion about math education on Hacker News:

For more recent videos, including YouTube, there's this media guide:

Nick Doiron
Flash Player
needed for firefox viewing of Khan academy lectures


  • How to make your own custom Sugar-Creation_Kit.iso file (How this DVD was converted to an .iso file)
    1. Collect, annotate and sort the files you want in a folder on your Desktop.
    2. Burn the contents of this folder to a CD or DVD.
    3. Use the following command in Terminal as the root user:
      dd if=/dev/sr0 of=Sugar-Creation-Kit.iso
    Sample output:
         dd if=/dev/sr0 of=Sugar-Creation-Kit.iso
         5555584+0 records in
         5555584+0 records out
         2844459008 bytes (2.8 GB) copied, 232.86 s, 12.2 MB/s
  • the resulting .iso file can be sent over the internet or used to make copies by burning to a DVD
  • How To Sugarize a Program
Instructions on how to make a program appear in the (F3) Home view of Sugar as an icon
Running Linux Applications Under Sugar

The Undiscoverable

click this link ^ for more details and examples
(The Undiscoverable Features of Sugar)
Features and tips not easily discovered about using Sugar
HTMLDOC software, version 1.8.27. HTMLDOC converts Hyper-Text Markup Language ("HTML") input files
into indexed HTML, Adobe® PostScript®, or Adobe Portable Document Format ("PDF") files.


Graphic installers

Liveusb Creator
Click link above ^ for details
Fedora and Windows (BEST METHOD TO USE)
openSUSE Live USB stick

Expert install methods

click this link ^ for more details and examples
Use "dd" command
click this link ^ for more details and examples. For ADVANCED USERS ONLY.
to make an install USB from a liveCD .iso file
Use (live).iso and terminal to make bootable USB
Use to install to HD or USB without needing a DVD/CD ROM
Building a bootable Mac USB
Click above Link ^
(tested on a MacBook Air)
Boot Helper CD's
  • MAC SoaS-3 Mirabelle Boot DISK
soas-3-boot-test.iso (Burn this to a CD and boot with it)
Read Me First & Credits to Programmer
  • MAC SoaS-4 Mango Lassi Boot DISK
soas-4-boot-test (Burn this to a CD and boot with it)
  • rEFIt
burn a bootable rEFIt CD on Mac OS X Used to Boot live USB's in a Mac
rEFIt is a boot menu and maintenance toolkit for EFI-based machines like the Intel Macs.
You can use it to boot multiple operating systems easily, including triple-boot setups with Boot Camp.
It also provides an easy way to enter and explore the EFI pre-boot environment.

Backup and Restore

QEMU Virtualization

click this link ^ for more details and examples
In Gnome terminal:
yum install @virtualization
Start (Graphical): Applications/System Tools/Virtual Machine Manager
  • installs soas.iso files to VM HD (with liveinst command in terminal of running Virtual Machine)


BoxGrinder creates appliances (also called images) from simple plain text Appliance Definition files.

VMware Player Virtualization

click this link ^ for more details and examples

Download VMware Player (free)

VMware Player Appliances

  • VMware Player appliance of SoaS-v3-Mirabelle
Compressed in .zip file
This appliance is ready to run "firstboot" (agree/user name/password/tz/etc)
sugarroot is the root password.
  • VMware Player appliance Trisquel-3 (NEW) 01/05/2011
Compressed in .zip file
  • VMware Player appliance Trisquel-4+sugar (NEW) 01/05/2011
Compressed in .zip file
  • VMware Player appliance Sugar on a Stick v2 (Blueberry)
Read this first.
  • VMware Player appliance of openSUSE-Sugar
Read this first.
networking help
how to use

VirtualBox Virtualization

click this link ^ for more details and examples

With VirtualBox® one can run Sugar in a window on Microsoft Windows, Intel-based Apple Macintosh, or Linux host computers from a virtual machine (VM) window. VirtualBox overview

  • VirtualBox
  • A good solution for Macintosh computers
  • click above link ^ to download (1.1GB)
  • This DVD.iso is a great way to "SneakerNet" distribute this VM Appliance
Revised 03/02/2011 to remove sugar identity
  • Contents of DVD:
Instructions and .vmdk/.ovf files to import
32bit-VirtualBox Installers (OSE) (Directory with install files for VirtualBox 4.0.4)
(Does not include Free for Personal Use licensed extension pack) - includes instructions on how to download for personal use.
ReadMeFirst_Install_Instructions.pdf  (Instructions-how to install VirtualBox and import appliance)
UserManual.pdf (VirtualBox 4.0.4 User Manual-269 pages)
  • Cleared of Sugar Learner identity. Starts on color selection screen (Click the <===(back) button to change the Learner name.)



All Prebuilt VirtualBox Appliances

click this link ^ to see a complete list of available VirtualBox Appliances
Try the appliances listed below first.
they are listed with the Recommended version first and older ones below.

Trisquel icon.pngTrisquel-4.1-sugar

(click this ^ link for details)
  • Sugar Desktop ONLY
Ubuntu 10.04 LTS with Sugar sweets 0.88.1
  • Cleared of sugar identity; Starts on Color Selection Screen ( <===(back) to change/ customize name)

Fedora-small.jpg Sugar on a Stick v3 Mirabelle

firstboot has not yet run; so a new user name and password will be set for the gdm login on startup for the first time
How Built:
8-GB VirtualBox hard disc
English and English keyboard
USA-Los Angeles (Pacific timezone)
download and import 2 files: 533M   12K
  • Note1:Use the latest version of Oracle VM VirtualBox (3.2_10.8-64453 or later). Some appliances have multiple hard disc controllers and the earlier Sun VirtualBox 3.1 version does not support them.
  • Note2: All appliances were built on a MacBook Air with Oracle VM VirtualBox (3.2.10-r66523) then tested on a Ubuntu installation on an Acer Aspire One Netbook imported into VirtualBox (3.2.10 r66523)
  • Note3:Set ControlPanel/Frame "Edge" slider to far left for easier access to sugar-frame features

Fedora-small.jpg Sugar on a Stick v2 Blueberry

Download these three files:

Sugar Clone

customize or duplicate Live USB installations
(script files for making a customized Live USB installation self­-replicating)
Rebuild/Refresh a custom SoaS iso from a running stick
Possible Use Cases

(from Wiki Page)

Curriculum packaging
  1. A teacher wants to prepare a SoaS image with a custom set of installed Activity bundles or a Journal of Activity instances for an upcoming class term.
  2. The teacher modifies their current working image by adding or deleting Activity bundles from their Home view and adding or removing Journal entries with specific content
   (such as a Physics model template or Etoys project), even saving distributable ebooks, or bookmarks in Browse Activity instances that are named for specific sets of local web destinations
   (a class portal perhaps for deployments lacking Internet connectivity).
  3. The teacher scrubs out any personal passwords or other history that should not be shared in the new copies.
  4. A fresh or recycled USB stick is inserted into the computer running the customized SoaS image and the SugarClone script is executed. 
Full image backup or sharing
  1. A Learner has modified their environment, perhaps adding Activity bundles and prepared specific instances such as a Activities/Physics simulation.
  2. Their modifications include changes to their operating system installed through yum or RPM to obtain some new core functionality.
  3. The Learner wants to archive or share this image with friends or for a backup.
  4. Personal or private information is scrubbed from the Journal or Browse history and other potential stores.
  5. The User creates one or more Sugar Clones. 

This method of backup has the advantage that it copies Learner changes to the core operating system as well as the Journal. A LiveOS image using a separate persistent home folder could be partially cloned with either the operating system overlay or home folder without the other should that be desired.

Build Your Own Remix with Fedora (Advanced)

click this link ^ for more details and examples
Make your own Custom CD/DVD.iso with a customized kickstart file
  • Links to Trisquel, Debian and Mandriva on how to remix Live CD's

XO-1 & XO-1.5


  • ARM

Fedora Sugar Bugs


Login pops up 11 times when starting sugar-emulator:

Development Team Packaging

Sugar Bugs

  • Sugar on a Stick
Sugar on a Stick Bugs
Current Soas Bugs satellit
  • SoaS-Sugar (fgrose)
  • 0.90-olpc (pbrobinson)