Revision as of 05:41, 5 January 2010 by Dfarning (talk | contribs) (refactored page and removed section on unbutu 8.10 as it was too out of date to be usefull.)
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.


Sugar on Ubuntu

As of December 2009, We started a total refactoring of how Sugar is packaged in Ubuntu.

Please See the Ubuntu Sugarteam wiki at https://wiki.ubuntu.com/SugarTeam for the latest information.

The Sugar packages for Ubuntu provide a Sugar environment that is easy to install and can be configured as an X session in gdm or run in a window with sugar-emulator.

Sugar on Ubuntu 10.04 (lucid)

Lucid has Sugar 0.88, 0.86, and 0.84 packages synced from Debian.

The current preferred method of running Sugar on the ubuntu is via Ubuntu Sugar Remix which can be downloaded at http://people.sugarlabs.org/dfarning

Packages can also be install via sudo

sudo apt-get install sugar sugar-activities

Sugar on Ubuntu 9.10 (karmic)

The prefered way to run Sugar on karmic is via sugar-* PPA. The purposes to have these PPAs are that for now there is a lack of official sugar packages in ubuntu(hope it will be resolved soon by porting Debian packages) and give users a chance to test last development releases.

Its possible because these PPAs are based on packages generated by jhconvert, its not a problem to support them. These packages are pretty simple and straightforward and were generated with one idea in mind - start sugar, so they don't follow any Debian/Ubuntu policies and aren't intended to be official packages.

Before attaching ppa, load gpg key

gpg --keyserver keyserver.ubuntu.com --recv 86ABE8AE363C5DAC
gpg --export --armor 86ABE8AE363C5DAC | sudo apt-key add -

gpg --keyserver keyserver.ubuntu.com --recv F265806A9BFFF0F4
gpg --export --armor F265806A9BFFF0F4 | sudo apt-key add -

To use Sucrose-0.84 on 8.04(Hardy)

sudo sh -c 'echo deb http://ppa.launchpad.net/alsroot/trisquel-edu/ubuntu hardy main >> /etc/apt/sources.list'
sudo apt-get update
sudo apt-get install sugar-platform

To use Sucrose-0.86 on 9.04(Jaunty). You need to update metacity from this PPA.

sudo sh -c 'echo deb http://ppa.launchpad.net/alsroot/trisquel-edu-3/ubuntu jaunty main >> /etc/apt/sources.list'
sudo apt-get update
sudo apt-get install metacity
sudo apt-get install sugar-platform 

To use Sucrose-0.86 on 9.10(Karmic)

sudo sh -c 'echo deb http://ppa.launchpad.net/sugarteam/0.86/ubuntu karmic main >> /etc/apt/sources.list'
sudo apt-get update
sudo apt-get install sugar-platform
(**NOTE: "https://launchpad.net/~sugarteam/+archive/0.86 repo looks empty
I guess the major plan for ubuntu team is using debian's sugar"
note from  alsroot) satellit 01/04/2010
  • so these instructions DO NOT WORK at present.

Note from lists

Message: 2 ****( this did not work) satellit 01/04/2010 Date: Mon, 23 Nov 2009 15:02:19 -0500 From: Kevin Cole <dc.xxxxxx.com> Subject: Re: [IAEP] 'apt-get install sugar-platform' available for Ubuntu9.10. Ubuntu (Karmic) now provides a nicer way to add repositories. Type the following at a shell prompt:

sudo add-apt-repository ppa:sugarteam/0.86

Using the command above results in both importing the GPG key for a PPA and creates a file in /etc/apt/sources.list.d/ named "sugarteam-0.86-karmic.list" with all the proper magic in it. The output of the command looks like this (line-wrapped for readability):

$ add-apt-repository ppa:sugarteam/0.86
Executing: gpg --ignore-time-conflict \
                      --no-options \
                      --no-default-keyring \
                      --secret-keyring /etc/apt/secring.gpg \
                      --trustdb-name /etc/apt/trustdb.gpg \
                      --keyring /etc/apt/trusted.gpg \
                      --keyserver keyserver.ubuntu.com \
                      --recv 74F3C222CB79383175656A6986ABE8AE363C5DAC
gpg: requesting key 363C5DAC from hkp server keyserver.ubuntu.com
gpg: key 363C5DAC: public key "Launchpad PPA for Sugar Team" imported
gpg: Total number processed: 1
gpg:               imported: 1  (RSA: 1)

Sugar on Ubuntu 9.04 (jaunty)

Jaunty, the current Ubuntu release, has Sucrose 0.83 packages synced from Debian.

Sugar does not work out-of-the-box under Jaunty as of 2009-07-01, although there is a workaround. See the discussion here for more information.

That work around doesn't work.--Dennis Daniels 00:38, 7 August 2009 (UTC)

0.84 Works for me from https://launchpad.net/~alsroot/+archive/ppa package name is sugar-platform --User:Satyaakam 22:00,12 August 2009 (IST)

  • works for me on 9.04 using ppa [1] Oct 31 2009


Installation instructions:

sudo apt-get install sugar sugar-activities

Sugar on Ubuntu 8.10 (intrepid)

Intrepid, the previous Ubuntu release, has Sucrose 0.82 packages synced from Debian.


Installation instructions:

sudo apt-get install sugar sugar-activities

Running Sugar

Run sugar in a window under a gnome login, using the Applications menu > Other > Sugar Emulator, or running the following in a terminal:


If everything is working fine, you can log into Sugar from the gdm login screen instead of running sugar-emulator.


If you are experiencing problems after upgrading from 8.04 (Hardy), please do the following to uninstall the partially-upgraded packages:

sudo apt-get purge sugar sugar-\*

and repeat the installation command outlined above to install only the new packages.

Reporting Bugs

If you need log files for debugging, use the following command in a GNOME terminal (not Sugar Terminal) to run sugar with debug logs turned on:


This generates log files in the .sugar/default/logs directory under your home directory.

To report a bug on Sugar or one of the Sugar activities on Ubuntu, use the following steps:

  • Go to https://launchpad.net/sucrose which represents all the Sugar components and activities supported in Ubuntu.
  • Click on the appropriate component at the bottom of the page. If in doubt, click "Sugar shell" which is the base Sugar component.
  • On the resulting page, scroll down to "Packages" and click on the hardy or intrepid package.
  • On the resulting page, click on the "Bugs" tab at the top of the page.
  • That takes you to a page listing known bugs on the package, and with a red "Report a bug" button.

Please include any relevant log files in a bug report: activity log files usually are named similarly to "org.laptop.Chat-1.log" (which is the log file for Chat). If you have run the activity multiple times in the current Sugar session, there will be Chat-2, Chat-3, etc so try to include the appropriate one.

If a problem or bug involves seeing (or not seeing) people in Neighborhood View, or activity sharing/collaboration, please also include presenceservice.log in the bug report.

Please note: The Ubuntu Sugar team will do their best to provide fixes for bugs, but it does take time to get an updated package uploaded through Ubuntu's Stable Release Updates process. Where possible we'll suggest a workaround, or provide a fix in the Sugar Team PPA first.

ejabberd collaboration server on Ubuntu

We use ejabberd for a collaboration server. Ubuntu 8.10 ships with the required patches included in ejabberd, so you can install ejabberd, configure it and have working collaboration within minutes, using these installation instructions: http://wiki.laptop.org/go/Installing_ejabberd/deb

For Ubuntu 8.04 you need to build from source: http://wiki.laptop.org/go/Installing_ejabberd

Sugar Team =

Sugar on Ubuntu is packaged and maintained by the Ubuntu Sugar team, who welcome new contributors to test, document, triage, and make packages.

Sugar bug reporting Ubuntu.