Getting Started

Please help us improve this page.
Tell us how it could be improved.

About Sugar

Sugar is a desktop environment that is an alternative to the ones typically used in Microsoft Windows, Apple's OS X or other GNU/Linux operating systems. It is conceived as a platform upon which children learn with Sugar Activities. The platform provides mechanisms for collaboration, reflection, and exploration. Sugar Activities cover a broad range of applications: browsing, drawing, composing, writing, programming, etc. See this gallery of screenshots.

Introduction to the Sugar Interface describes multiple full-screen views: a Home view, from which Activities are launched; a Neighborhood view, where learners can connect to each other through a Jabber network; a Journal view, which can be used as a lab notebook; and the Activity view, where Sugar Activities are run.

Sugar Activities have no Save menu: everything is saved automatically. While the interface uses very little text, additional information is revealed when the user hovers over icons.

Sugar is Free Software. It is developed in Python and runs on a GNU/Linux Kernel, originally from the Fedora Project, and now from a variety of GNU/Linux distributions.

For an overview of the components composing a Sugar system see the Sugar System Stack.

Getting Sugar

This section aims to be an introductory walkthrough of some of the methods of installing Sugar covered on the page Sugar on a Stick/Installation.

Hardware requirements

Before you download, you need to know if you can use the 64-bit version. If your computer says on the box or documentation that it is 64-bit, you may use the 64-bit download version of Sugar called "x86_64". If you have an Intel MacIntosh, you will need the 64-bit x86_64 version. It is fairly safe to say that PCs above Pentium 2 (commenced production end 1995) and meeting the specification below can run the "i686" version. Sticks made with the "i686" version may be more transferrable between different PCs.

Fedora developers reported these minimum requirements for the Fedora 17 distributions.

A 400 MHz or faster processor

At least 512 MB memory (RAM), 1 GB recommended for best performance.

However by Fedora 19 specifications have risen ( http://docs.fedoraproject.org/en-US/Fedora/19/html/Release_Notes/sect-Release_Notes-Welcome_to_Fedora_.html#hardware_overview ) to:

A 1GHz or faster processor

1GB System Memory - RAM

These higher specifications are probably not critical to Sugar on a Stick made by the Fedora Live USB Creator method. However the LiveCD may not boot on a PC with RAM lower than 768 MB, you may encounter an automated check which causes the boot to abort if insufficient memory is found. Sugar on a Stick/Boot #Troubleshooting #Low Memory, RAM, Hardware describes a workaround.

Lower memory machines may work, the XO-1 runs with 256 MB, but running Sugar from a USB stick in a PC, (x86), environment with 256 MB RAM will be sub-optimal.

You will need to ensure the computer you plan to use is capable of booting from CD or USB.

On older machines, you will probably need to make a change in the BIOS (see your computer's hardware documentation). Change Boot Order, so that Boot from CD or Boot from USB comes before Boot from Hard Drive. Many newer computers detect the USB device as a hard drive, see http://www.pendrivelinux.com/usb-bios-boot-options/

For SoaS the recommended minimum size of your USB flash drive is 2 GB, although a 1 GB drive will also work.

Sugar Live CD

The Sugar LiveCD contains a complete, functioning Sugar distribution and operating system on CD.

The Sugar LiveCD does not alter files already installed on your computer. It returns to its previous state when the LiveCD is ejected and the computer is rebooted. The Sugar LiveCD allows you to temporarily run Sugar; this allows you to explore Sugar and test how Sugar runs on your hardware. Your settings will not be saved between boots, but you can experiment with inserting a USB stick into the computer running the LiveCD, and reading from, and saving work to, the USB stick.

Produce your LiveCD by downloading the Sugar on a Stick .iso image from Sugar on a Stick/Downloads and burning it onto a blank CD.

Many computers have built in software which will convert and copy, "burn", an .iso image to a blank CD. Windows 7 contains a built-in Disk Image Burner http://windowsteamblog.com/blogs/windowsexperience/archive/2009/04/13/burn-iso-images-natively-in-windows-7.aspx or use a free utility, like ImgBurn.

To run Sugar, insert your LiveCD into your computer and reboot into Sugar.

Sugar on a Stick

Use Fedora Live USB Creator

The page Sugar on a Stick/Installation describes a number of methods of installing Sugar on a Stick. Here we walk through the first and most simple method.

Only the Graphical User Interface is used. The method is suitable for use with a Windows computer. (Fedora Live USB Creator also works on any Fedora system too.)

Have a look at the Fedora program you will use: https://fedorahosted.org/liveusb-creator/

If you are happy you have covered the above, you are ready to follow the instructions on Sugar on a Stick/Installation

If all has worked, you will shutdown your PC. With the newly written USB stick in a USB port, restart the PC. See Sugar on a Stick/Boot for extra information.

This method is covered in this screenshot tutorial: Tutorials/Installation/Create a SoaS v7 Live USB in Windows and in this video of an earlier version of this process.

livecd-iso-to-disk

This is the second method described on the page Sugar on a Stick/Installation#with Microsoft Windows

This is a robust method of making a Sugar on a Stick because you are making your LiveUSB from within Sugar, with a LiveCD you have already tested, and all tools are already on the CD.

You do not have to be a paid up member of the Windows community. If you already run a Linux distribution, but are not sure to what extent it supports Sugar, the livecd-iso-to-disk tool will work on any PC which will launch the LiveCD.

You may need to spend a bit of time to become familiar with the Sugar environment using your LiveCD, see Getting Started/Explore. You need to become familiar with the Terminal Activity and how to gain administrative permissions, that is become root.

For futher background reading, this paragraph from the Fedora wiki describes the livecd-iso-to-disk tools in some detail. http://fedoraproject.org/wiki/How_to_create_and_use_Live_USB#Command_line_method:_Using_the_livecd-iso-to-disk_tool_.28Fedora_only.29

To proceed with livecd-iso-to-disk, full instructions are here, Sugar on a Stick/Installation#with Microsoft Windows, in Method 2, Burn a CD-ROM disc, boot from it, then run the script, livecd-iso-to-disk

Sugar on a Virtual Machine

The advantage of a Virtual Machine (VM) is that, with the full VM documentation provided online, you follow that documentation to install the VM on your PC or Mac. VirtualBox^® is a suitable choice of VM for a first attempt, see their website: https://www.virtualbox.org/

As ever, download the Sugar on a Stick .iso from Sugar on a Stick/Downloads

Open the VM, bind the .iso image to the VM and boot it.

All VMs have excellent documentation on how to boot an .iso and again it is covered on this page Sugar on a Stick/Installation#SoaS on VirtualBox and the method to make a Sugar on a Stick from your VM, is covered here Sugar on a Stick/Installation#with Microsoft Windows in Method 3, Launch a virtual machine with the Sugar on a Stick .iso file, then run the script, livecd-iso-to-disk

Sugar on Fedora

If you have (or create) a computer running the Fedora operating system, Sugar can be installed and launched as follows.

Installing Sugar

Using GUI, from the Applications Menu, Select Administration, Select Software. Enter Sugar in the search field.

Among all the packaged Activities select,

"The emulator for the Sugar Learning Environment" sugar-emulator._{version-number}

and/or "Sugar Desktop Environment" sugar-desktop

and any or all of the Activities.

Or, using the command line, in a root terminal, enter

yum install @sugar-desktop  sugar-emulator        

Launching Sugar

With sugar-desktop and sugar-emulator installed you have two ways of running Sugar.

From the Applications Menu, Select Education, Select Sugar

The sugar emulator (also known as Sugar in a Window) will launch.

To launch the Sugar Desktop Environment (also known as a Sugar session) you must reboot.

When you reboot Fedora, at the point where you login, a Sugar entry will now be present in the login prompt, or under "Session Type", or (as shown in the image below) by clicking on the star.

Select "Sugar" within the login prompt, enter your password, and Enter, and the computer will boot into Sugar Desktop Environment.

Note sugar-emulator does not exist in f20

• A replacement (sugar-runner?) is still being developed.As a result theree is not Entry in the Education menu for sugar.
• To run sugar:

root terminal:

yum install @sugar-desktop

logoff

select sugar from the De (GDM or lightdm) from the star under the password login screen

600px

• enter password

Sugar as a DE will start full screen.

Please Explore Sugar

and take it out into your community

There are two further pages in the Getting Started set.

Once you are able to launch Sugar, see Getting Started/Explore.

If you can take Sugar out into your school or community, see Getting Started/Presentation for ideas on how to demonstrate it to others.

I need more information

For help, see Find help.

See Supported systems.

The Sugar Labs wiki is a collaboration site for Sugar Labs teams, the Sugar on a Stick project alone comprises over 75 pages or sub-pages. For additional information, you might look at Sugar on a Stick/Project sitemap

There is an introductory overview of The Sugar Learning Platform at http://www.sugarlabs.org/. You can also reach this site from the navigation bar along the top of this page, by clicking the tab labeled "web" at the far left end.

Notice this set of pages also includes an overview sitemap.

Release notes

Release notes for Sugar 0.121 are available here.

Sugar platform release version cycle: | 0.82 | 0.84 | 0.86 | 0.88 | 0.90 | 0.92 | 0.94 | 0.96 | 0.98 | 0.100 | 0.102 | 0.104 | 0.106 | 0.108 | 0.110 | 0.112 |