<?xml version="1.0"?>
<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="en">
	<id>https://wiki.sugarlabs.org/api.php?action=feedcontributions&amp;feedformat=atom&amp;user=Colin.applegate</id>
	<title>Sugar Labs - User contributions [en]</title>
	<link rel="self" type="application/atom+xml" href="https://wiki.sugarlabs.org/api.php?action=feedcontributions&amp;feedformat=atom&amp;user=Colin.applegate"/>
	<link rel="alternate" type="text/html" href="https://wiki.sugarlabs.org/go/Special:Contributions/Colin.applegate"/>
	<updated>2026-04-16T20:51:30Z</updated>
	<subtitle>User contributions</subtitle>
	<generator>MediaWiki 1.43.0</generator>
	<entry>
		<id>https://wiki.sugarlabs.org/index.php?title=Development_Team/Jhbuild&amp;diff=37116</id>
		<title>Development Team/Jhbuild</title>
		<link rel="alternate" type="text/html" href="https://wiki.sugarlabs.org/index.php?title=Development_Team/Jhbuild&amp;diff=37116"/>
		<updated>2009-09-11T14:57:40Z</updated>

		<summary type="html">&lt;p&gt;Colin.applegate: /* Jhbuild FAQ */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;&amp;lt;noinclude&amp;gt;{{ GoogleTrans-en | es =show | bg =show | zh-CN =show | zh-TW =show | hr =show | cs =show | da =show | nl =show | fi =show | fr =show | de =show | el =show | hi =show | it =show | ja =show | ko =show | no =show | pl =show | pt =show | ro =show | ru =show | sv =show }}&amp;lt;/noinclude&amp;gt;&lt;br /&gt;
{{Translations}}&lt;br /&gt;
&lt;br /&gt;
Sugar-jhbuild will automatically download the latest of Sugar&#039;s dependencies as well as Sugar itself directly from their source repositories, rather than relying on source packages that may have become stale. Below are generic instructions on how to use jhbuild to get up and running with Sugar.&lt;br /&gt;
&lt;br /&gt;
==Compatible Platforms==&lt;br /&gt;
&lt;br /&gt;
Jhbuild is quite demanding with regard to the packages and setup for the host Linux distribution. As a result there are only a few Linux distributions which are known to work with it.&lt;br /&gt;
&lt;br /&gt;
See the distribution specific instructions for information about whether your distribution is currently supported. Other distros which have a recent-enough release (e.g. including the latest stable GNOME release) can be supported if someone is willing to maintain the dependencies for that distro release (in config/sysdeps).&lt;br /&gt;
&lt;br /&gt;
==Check distro-specific instructions==&lt;br /&gt;
&lt;br /&gt;
Many distributions have some quirks that need to be catered for and there are different package managing tools in use, so please check the page for your distribution before proceeding:&lt;br /&gt;
&lt;br /&gt;
* [[/Debian | Debian]]&lt;br /&gt;
* [[/Fedora | Fedora]]&lt;br /&gt;
:Here are some [http://www.youtube.com/profile?user=pleabargain&amp;amp;view=videos&amp;amp;query=jhbuild videos of the Fedora jhbuild install process]. &lt;br /&gt;
* [[/Ubuntu | Ubuntu]]&lt;br /&gt;
* [[/Mandriva | Mandriva]]&lt;br /&gt;
&lt;br /&gt;
==Some general advice==&lt;br /&gt;
&lt;br /&gt;
Note: Like most other Unix applications, sugar-jhbuild should never be run as root. It may easily screw up your whole system and/or break in unexpected ways if you do. If you get any permissions error, there&#039;s something wrong with your installation that should be fixed.&lt;br /&gt;
&lt;br /&gt;
If you&#039;re stuck or if you get strange errors, feel free to ask for help on the [[Sugar_Labs/Contacts#irc.freenode.net_channels|#sugar IRC channel]] or the [[Sugar_Labs/Contacts#Developer_Lists|sugar-devel mailing list]]. Don&#039;t waste too much time chasing strange problems: usually it&#039;s caused by some basic, easy to fix problem. You might also want to check the [http://dev.sugarlabs.org/query?status=accepted&amp;amp;status=assigned&amp;amp;status=new&amp;amp;status=reopened&amp;amp;component=sugar-jhbuild bug tracker] to see if it&#039;s a known issue.&lt;br /&gt;
&lt;br /&gt;
==Jhbuild FAQ==&lt;br /&gt;
Q: &lt;br /&gt;
&amp;lt;dgd&amp;gt; jhbuild build on fedora11 requires 29 packages but on Ubuntu904 38... should I be concerned with the difference in number?&lt;br /&gt;
A:&lt;br /&gt;
&amp;lt;sdziallas&amp;gt; dgd: this can be caused by different packaging policies...&amp;gt;&amp;gt;&amp;gt;&amp;lt;dgd&amp;gt; sdziallas, ergo not a reason for concern, thanks!&lt;br /&gt;
&lt;br /&gt;
definitely do not compile as root with jhbuild -- you&#039;ll run into funky problems -- Colin A. :)&lt;br /&gt;
&lt;br /&gt;
==Check out sugar-jhbuild==&lt;br /&gt;
&lt;br /&gt;
In a suitable directory (i.e. usually your user&#039;s home directory i.e. /home/yourusername/~), execute&lt;br /&gt;
 git clone git://git.sugarlabs.org/sugar-jhbuild/mainline.git sugar-jhbuild&lt;br /&gt;
&lt;br /&gt;
::Make sure you are in the _user&#039;s_ home directory&lt;br /&gt;
:: video http://www.youtube.com/watch?v=Tdr1bs4rQ_s&lt;br /&gt;
&lt;br /&gt;
You&#039;ll know if it worked if you get something like this:&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
localhost ~]$ git clone git://git.sugarlabs.org/sugar-jhbuild/mainline.git sugar-jhbuild&lt;br /&gt;
Initialized empty Git repository in /home/denny/sugar-jhbuild/.git/&lt;br /&gt;
remote: Counting objects: 4688, done.&lt;br /&gt;
remote: Compressing objects: 100% (1998/1998), done.&lt;br /&gt;
remote: Total 4688 (delta 2759), reused 4488 (delta 2638)&lt;br /&gt;
Receiving objects: 100% (4688/4688), 1.86 MiB | 197 KiB/s, done.&lt;br /&gt;
Resolving deltas: 100% (2759/2759), done.&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
==Build sugar base system and its dependencies==&lt;br /&gt;
&lt;br /&gt;
Go into the directory you created and start the build. It takes about 30 minutes on a 1.6ghz machine with a wireless G connection.&lt;br /&gt;
&lt;br /&gt;
 cd sugar-jhbuild&lt;br /&gt;
 ./sugar-jhbuild update&lt;br /&gt;
 ./sugar-jhbuild depscheck&lt;br /&gt;
 ./sugar-jhbuild build&lt;br /&gt;
::[http://www.youtube.com/results?search_query=pleabargain+jhbuild&amp;amp;search_type=&amp;amp;aq=f Here are videos of the process]. Before saying that [http://www.youtube.com/ Youtube] is unfriendly to Linux because of the flash player, try installing it. [http://get.adobe.com/flashplayer/ Adobe flash works] on my Ubuntu 9.04 and Fedora 11 without hitch.&lt;br /&gt;
&lt;br /&gt;
And now run it.&lt;br /&gt;
 ./sugar-jhbuild run&lt;br /&gt;
&lt;br /&gt;
If it doesn&#039;t run or you have other problems read on.&lt;br /&gt;
=== Dealing with dependencies ===&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;sugar-jhbuild depscheck&#039;&#039; will print a list of required packages. They are part of the distribution you&#039;re using and should be installed using your favourite package manager (e.g. aptitude/synaptic for Debian, yum for Fedora).&lt;br /&gt;
&lt;br /&gt;
If you notice that there&#039;s a package missing from the &amp;lt;code&amp;gt;./sugar-jhbuild depscheck &amp;lt;/code&amp;gt; output (i.e. it&#039;s required for Sugar to work properly and not installed, but depscheck does not mention it), please [http://dev.sugarlabs.org/newticket?component=sugar-jhbuild&amp;amp;version=Git%20as%20of%20bugdate&amp;amp;type=defect&amp;amp;summary=Need%20package%20%3cinsert%20name%20of%20package%3e%20on%20%3cinsert%20name%20of%20distribution%3e&amp;amp;description=%3cplease%20explain%20why%20you%20think%20the%20package%20is%20required%20%28e.g.%20error%20message%29%3e file a bug report] (login required first, but currently no automatic redirection to login page) against the sugar-jhbuild Component in the [http://dev.sugarlabs.org/ Sugar Labs bug tracker].&lt;br /&gt;
&lt;br /&gt;
===Some tips and known issues===&lt;br /&gt;
* hulahop stopped building because I had installed a more recent version of xulrunner on my machine. The workaround was to &amp;lt;code&amp;gt;rm -rf ~/sugar-jhbuild/source/hulahop&amp;lt;/code&amp;gt; and then run update and build again.&lt;br /&gt;
*25 Aug 9: hulahop doesnt&#039; build correctly. http://lists.sugarlabs.org/archive/sugar-devel/2009-August/018540.html The &#039;fix&#039; is running autoconf.&lt;br /&gt;
::Question. How do you run autoconf to fix this problem?&lt;br /&gt;
::: when you get asked because of the error, choose the configure stage&lt;br /&gt;
&lt;br /&gt;
== Run Sugar ==&lt;br /&gt;
&lt;br /&gt;
This command launches the Sugar emulator:&lt;br /&gt;
&lt;br /&gt;
 ./sugar-jhbuild run&lt;br /&gt;
&lt;br /&gt;
To exit the emulator, press Alt-Q.&lt;br /&gt;
&lt;br /&gt;
Note that due to a [http://dev.sugarlabs.org/ticket/342 bug in Xephyr] your keyboard might not work as expected. A partial workaround is to run &amp;lt;code&amp;gt;setxkbmap &amp;amp;lt;keymap name&amp;amp;gt;&amp;lt;/code&amp;gt; in &amp;lt;code&amp;gt;~/.sugar/debug&amp;lt;/code&amp;gt; (this file will be created on first run of Sugar). Most &amp;quot;regular&amp;quot; keys should work fine after that, some &amp;quot;special keys&amp;quot; (e.g. cursor up/down) might still refuse to operate as intended.&lt;br /&gt;
&lt;br /&gt;
The &amp;quot;keymap name&amp;quot; usually is a two letter country code, e.g. &amp;quot;de&amp;quot; for german or &amp;quot;fr&amp;quot; for french.&lt;br /&gt;
&lt;br /&gt;
== Running multiple instances ==&lt;br /&gt;
To run multiple instances of sugar you can start it in the following way:&lt;br /&gt;
&lt;br /&gt;
 SUGAR_PROFILE=2 ./sugar-jhbuild run&lt;br /&gt;
&lt;br /&gt;
This will create a new profile in ~/.sugar/, i.e. ~/.sugar/2/. You will find logs and configuration for this instance here. The default profile is ~/.sugar/default/&lt;br /&gt;
&lt;br /&gt;
== Run an individual activity ==&lt;br /&gt;
&lt;br /&gt;
Within sugar, e.g. in Terminal, this command launches an individual activity for testing:&lt;br /&gt;
&lt;br /&gt;
 sugar-launch [bundle name]&lt;br /&gt;
&lt;br /&gt;
You will see debug output appearing in Terminal.&lt;br /&gt;
&lt;br /&gt;
== Configure the mode and resolution of Sugar ==&lt;br /&gt;
&lt;br /&gt;
You can make Sugar run fullscreen or specify a size (in pixels):&lt;br /&gt;
&lt;br /&gt;
 ./sugar-jhbuild run sugar-emulator --fullscreen&lt;br /&gt;
 ./sugar-jhbuild run sugar-emulator --dimensions 1200x900&lt;br /&gt;
&lt;br /&gt;
The default size of 800x600 is currently the minimum that should work without issues. I.e. activities should be tested to work in this mode (and in others as well).&lt;br /&gt;
&lt;br /&gt;
== Other commands ==&lt;br /&gt;
&lt;br /&gt;
JHBuild has several other commands that can be useful for development. You can get an overview with:&lt;br /&gt;
&lt;br /&gt;
 ./sugar-jhbuild --help-commands&lt;br /&gt;
&lt;br /&gt;
A useful sequence of commands for building Sugar, from the [http://mailman.laptop.org/pipermail/sugar/2007-February/001352.html Sugar mailing list]: (Note that build will update first anyway, so run update separately if you want to see what changed more easily.)&lt;br /&gt;
&lt;br /&gt;
 ./sugar-jhbuild update&lt;br /&gt;
 ./sugar-jhbuild build -a --clean&lt;br /&gt;
 ./sugar-jhbuild run&lt;br /&gt;
&lt;br /&gt;
The use of -a and --clean flags are needed when a file is removed so that autogen.sh is run. &#039;&#039;&#039;Note:&#039;&#039;&#039; Some packages, e.g., squeak and etoys, don&#039;t have a &#039;&#039;make clean&#039;&#039;. Just ignore the error.&lt;br /&gt;
&lt;br /&gt;
== If build breaks after an update ==&lt;br /&gt;
&lt;br /&gt;
The packages in sugar-jhbuild are the latest development versions, so you not only get the latest features, but also the latest breakages. The dependencies may change often, too, so be sure to run&lt;br /&gt;
 ./sugar-jhbuild depscheck&lt;br /&gt;
regularly and install the missing packages.&lt;br /&gt;
&lt;br /&gt;
If your problem persists for more than a day (and even though you installed all missing packages), please [http://dev.sugarlabs.org/newticket?component=sugar-jhbuild&amp;amp;version=Git%20as%20of%20bugdate&amp;amp;type=defect&amp;amp;summary=%3cPlease%20enter%20short%20summary%20of%20your%20problem%20here%3e&amp;amp;description=%3cplease%20copy%20exact%20error%20message%20and%20additional%20information%20here%3e file a bug report].&lt;br /&gt;
&lt;br /&gt;
== From within Sugar ==&lt;br /&gt;
Once you have Sugar running, here are some useful commands:&lt;br /&gt;
*&#039;&#039;&#039;Alt+Shift+F&#039;&#039;&#039; makes the frame appear and disappear&lt;br /&gt;
*&#039;&#039;&#039;Ctrl-Q&#039;&#039;&#039; quits an activity&lt;br /&gt;
*&#039;&#039;&#039;Alt+Shift+Q&#039;&#039;&#039; quits Sugar&lt;br /&gt;
*&#039;&#039;&#039;Alt+Shift+O&#039;&#039;&#039; opens the search&lt;br /&gt;
*&#039;&#039;&#039;Alt+Shift+R&#039;&#039;&#039; rotates the screen&lt;br /&gt;
&lt;br /&gt;
== Customize ==&lt;br /&gt;
&lt;br /&gt;
To customize the build create a configuration file, named &#039;&#039;.sugar.jhbuildrc&#039;&#039;, in your home directory.&lt;br /&gt;
&lt;br /&gt;
=== Write access to the repositories ===&lt;br /&gt;
&lt;br /&gt;
If you have write access to the repositories you can add this (if your login name happens to be marco):&lt;br /&gt;
 repos[&#039;gnome.org&#039;] = &#039;:ext:marco@cvs.gnome.org:/cvs/gnome&#039;&lt;br /&gt;
 repos[&#039;mozilla.org&#039;] = &#039;:ext:marco%gnome.org@cvs.mozilla.org:/cvsroot&#039;&lt;br /&gt;
 repos[&#039;dev.laptop.org&#039;] = &#039;git+ssh://marco@dev.laptop.org/git/&#039;&lt;br /&gt;
 repos[&#039;dev.laptop.org/projects&#039;] = &#039;git+ssh://marco@dev.laptop.org/git/projects/&#039;&lt;br /&gt;
&lt;br /&gt;
==Useful Internal Links==&lt;br /&gt;
* [[Development Team/Understanding the Code|Understanding Sugar Code]]&lt;br /&gt;
* [[Taxonomy]] -- explains the components of Sugar (Glucose, Fructose, Sugar, Starches)&lt;br /&gt;
* [[Sugar Instructions]] -- how to actually use Sugar once you have it running[http://en.flossmanuals.net/sugar]&lt;br /&gt;
&lt;br /&gt;
==External links==&lt;br /&gt;
&lt;br /&gt;
* [http://library.gnome.org/devel/jhbuild/unstable/ JHBuild manual]&lt;br /&gt;
* [http://www.redhatmagazine.com/2007/02/23/building-the-xo-introducing-sugar/ Red Hat Magazine article: Introducing Sugar]&lt;br /&gt;
* [http://learn.laptop.org/tinderbox/ Tinderbox] (see the &amp;quot;Sugar JHBuild&amp;quot; tab).  The old [http://dev.laptop.org/~cjb/sugar-tinder/ sugar-jhbuild tinderbox].&lt;br /&gt;
&lt;br /&gt;
[[Category:Installing Sugar]]&lt;br /&gt;
[[Category:Jhbuild]]&lt;/div&gt;</summary>
		<author><name>Colin.applegate</name></author>
	</entry>
	<entry>
		<id>https://wiki.sugarlabs.org/index.php?title=Ubuntu&amp;diff=35376</id>
		<title>Ubuntu</title>
		<link rel="alternate" type="text/html" href="https://wiki.sugarlabs.org/index.php?title=Ubuntu&amp;diff=35376"/>
		<updated>2009-08-17T20:08:26Z</updated>

		<summary type="html">&lt;p&gt;Colin.applegate: /* Sugar on Ubuntu */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;{{TOCright}}&lt;br /&gt;
[[Image:Ubuntu.jpg]]&lt;br /&gt;
&lt;br /&gt;
= Sugar on Ubuntu =&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
It is a much simpler platform to set up for activity developers than jhbuild, although is not bleeding-edge.&lt;br /&gt;
&lt;br /&gt;
@the below:&lt;br /&gt;
I am building a package for 9.04 as we speak. should be done in a few days. (by the 20th of August)&lt;br /&gt;
-Colin Applegate&lt;br /&gt;
&lt;br /&gt;
:{I might get flamed for this; I know I shouldn&#039;t post on a wiki like this, but no one will read the discussion: can we list a simple way of installing from jhbuild on Ubuntu 9.04 or installing from a PPA?  Is 0.83 in the Ubuntu sugar PPA recent enough?  How about installing from source (not git/jhbuild) and then adding an X session?  With Ubuntu being the most popular Linux distribution, it is in the interest of this project to flesh out these details.}&lt;br /&gt;
&lt;br /&gt;
Sugar on Ubuntu is packaged and maintained by the [https://wiki.ubuntu.com/SugarTeam Ubuntu Sugar team], who welcome new contributors to test, document, triage, and make packages.&lt;br /&gt;
&lt;br /&gt;
[https://launchpad.net/sugar Sugar bug reporting Ubuntu].&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Sugar on Ubuntu 9.04 (jaunty) ==&lt;br /&gt;
&lt;br /&gt;
Jaunty, the current Ubuntu release, has Sucrose 0.83 packages synced from [[Community/Distributions/Debian|Debian]].&lt;br /&gt;
&lt;br /&gt;
Sugar does not work out-of-the-box under Jaunty as of 2009-07-01, although there is a workaround. See the [[Talk:Community/Distributions/Ubuntu|discussion here]] for more information.&lt;br /&gt;
&lt;br /&gt;
:That work around doesn&#039;t work.--[[User:Dennis Daniels|Dennis Daniels]] 00:38, 7 August 2009 (UTC) &lt;br /&gt;
&lt;br /&gt;
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)&lt;br /&gt;
&lt;br /&gt;
=== Installing ===&lt;br /&gt;
&lt;br /&gt;
Installation instructions:&lt;br /&gt;
 sudo apt-get install sugar sugar-activities&lt;br /&gt;
&lt;br /&gt;
== Sugar on Ubuntu 8.10 (intrepid) ==&lt;br /&gt;
&lt;br /&gt;
Intrepid, the previous Ubuntu release, has Sucrose 0.82 packages synced from [[Community/Distributions/Debian|Debian]].&lt;br /&gt;
&lt;br /&gt;
=== Installing ===&lt;br /&gt;
&lt;br /&gt;
Installation instructions:&lt;br /&gt;
 sudo apt-get install sugar sugar-activities&lt;br /&gt;
&lt;br /&gt;
=== Running Sugar ===&lt;br /&gt;
&lt;br /&gt;
Run sugar in a window under a gnome login, using the Applications menu &amp;gt; Other &amp;gt; Sugar Emulator, or running the following in a terminal:&lt;br /&gt;
 sugar-emulator&lt;br /&gt;
&lt;br /&gt;
If everything is working fine, you can log into Sugar from the gdm login screen instead of running sugar-emulator.&lt;br /&gt;
&amp;lt;!--&lt;br /&gt;
The following does not currently work, but should in the future:&lt;br /&gt;
Some activities could not be included due to missing dependencies - notably Read and Write. These will be published in the [https://launchpad.net/~sugarteam/+archive Sugar Team PPA] soon, which can be accessed via&lt;br /&gt;
 sudo -s&lt;br /&gt;
 echo deb http://ppa.launchpad.net/sugarteam/ubuntu hardy main &amp;gt; /etc/apt/sources.list.d/sugar.list&lt;br /&gt;
 apt-get update &lt;br /&gt;
 apt-get install sugar sugar-emulator sugar-activities&lt;br /&gt;
--&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Upgrading ===&lt;br /&gt;
&lt;br /&gt;
If you are experiencing problems after upgrading from 8.04 (Hardy), please do the following to uninstall the partially-upgraded packages:&lt;br /&gt;
 sudo apt-get purge sugar sugar-\*&lt;br /&gt;
and repeat the installation command outlined above to install only the new packages.&lt;br /&gt;
&lt;br /&gt;
=== Reporting Bugs ===&lt;br /&gt;
&lt;br /&gt;
If you need log files for debugging, use the following command in a GNOME terminal &#039;&#039;(not Sugar Terminal)&#039;&#039; to run sugar with debug logs turned on:&lt;br /&gt;
 SUGAR_LOGGER_LEVEL=debug PRESENCESERVICE_DEBUG=1 sugar-emulator&lt;br /&gt;
&lt;br /&gt;
This generates log files in the .sugar/default/logs directory under your home directory.&lt;br /&gt;
&lt;br /&gt;
To report a bug on Sugar or one of the Sugar activities on Ubuntu, use the following steps:&lt;br /&gt;
* Go to https://launchpad.net/sucrose which represents all the Sugar components and activities supported in Ubuntu.&lt;br /&gt;
* Click on the appropriate component at the bottom of the page. If in doubt, click &amp;quot;Sugar shell&amp;quot; which is the base Sugar component.&lt;br /&gt;
* On the resulting page, scroll down to &amp;quot;Packages&amp;quot; and click on the hardy or intrepid package.&lt;br /&gt;
* On the resulting page, click on the &amp;quot;Bugs&amp;quot; tab at the top of the page.&lt;br /&gt;
* That takes you to a page listing known bugs on the package, and with a red &amp;quot;Report a bug&amp;quot; button.&lt;br /&gt;
&lt;br /&gt;
Please include any relevant log files in a bug report: activity log files usually are named similarly to &amp;quot;org.laptop.Chat-1.log&amp;quot; (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.&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Please note&#039;&#039;&#039;: 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&#039;s [https://wiki.ubuntu.com/StableReleaseUpdates Stable Release Updates] process. Where possible we&#039;ll suggest a workaround, or provide a fix in the [https://launchpad.net/~sugarteam/+archive Sugar Team PPA] first.&lt;br /&gt;
&lt;br /&gt;
== Sugar on Ubuntu 8.04 LTS (hardy) ==&lt;br /&gt;
&lt;br /&gt;
hardy includes an old version of Sugar, 0.79. You can install the current stable release of Sugar, 0.82, with the instructions below.&lt;br /&gt;
&lt;br /&gt;
For bug reporting, please follow the instructions above as for intrepid.&lt;br /&gt;
&lt;br /&gt;
=== Sugar 0.79.0 ===&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Old, but included in Hardy&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
Sugar was packaged in Universe for Hardy (Ubuntu 8.04) by Jani Monoses. The version packaged is 0.79.0, similar to the version in OLPC Release 8.1.0.&lt;br /&gt;
&lt;br /&gt;
[http://janimo.blogspot.com/2008/02/sugar-finally-in-hardy-universe.html Installation instructions]&lt;br /&gt;
&lt;br /&gt;
There are extra packages in a [https://launchpad.net/~sugar/+archive/ PPA], including activities that could not be included in the Ubuntu archive due to license issues, as well as updated abiword packages.&lt;br /&gt;
&lt;br /&gt;
We do recommend using the version 0.82 packages instead, as mentioned below:&lt;br /&gt;
&lt;br /&gt;
=== Sucrose 0.82 ===&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Up-to-date version, extra repository&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
The Ubuntu packages were updated to the latest [[Development Team/Release/Releases/Sucrose/0.82|0.82]] point release in the [https://launchpad.net/~sugarteam/+archive Sugar Team PPA].&lt;br /&gt;
&lt;br /&gt;
Installation instructions:&lt;br /&gt;
 sudo -s&lt;br /&gt;
 echo deb http://ppa.launchpad.net/sugarteam/ubuntu hardy main &amp;gt; /etc/apt/sources.list.d/sugar.list&lt;br /&gt;
 apt-get update &lt;br /&gt;
 apt-get install sugar sugar-emulator sugar-activities&lt;br /&gt;
&lt;br /&gt;
Not working, tried it from Hardy Install 05/06/2009 [satellit]&lt;br /&gt;
&lt;br /&gt;
== Using sugar PPAs ==&lt;br /&gt;
&lt;br /&gt;
Another way to start sugar on Ubuntu is using sugar-* PPA.&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;NOTE&#039;&#039;&#039; These PPAs use packages generated by [[Deployment_Team/jhconvert|jhconvert]], so if you have sugar packages installed by another method you need to remove them all:&lt;br /&gt;
 sudo apt-get remove -f $(dpkg-query -l | grep -e sugar -e olpc | awk &#039;{print $2}&#039;)&lt;br /&gt;
&lt;br /&gt;
Before attaching ppa, load gpg key&lt;br /&gt;
 gpg --keyserver keyserver.ubuntu.com --recv F265806A9BFFF0F4&lt;br /&gt;
 gpg --export --armor F265806A9BFFF0F4 | sudo apt-key add -&lt;br /&gt;
&lt;br /&gt;
To use sugar-0.84 on 8.04(Hardy)&lt;br /&gt;
 sudo sh -c &#039;echo deb http://ppa.launchpad.net/alsroot/trisquel-edu/ubuntu hardy main &amp;gt;&amp;gt; /etc/apt/sources.list&#039;&lt;br /&gt;
 sudo apt-get update&lt;br /&gt;
 sudo apt-get install sugar-platform&lt;br /&gt;
&lt;br /&gt;
To use sugar-0.84 on 9.04(jaunty)&lt;br /&gt;
 sudo sh -c &#039;echo deb http://ppa.launchpad.net/alsroot/ppa/ubuntu jaunty main &amp;gt;&amp;gt; /etc/apt/sources.list&#039;&lt;br /&gt;
 sudo apt-get update&lt;br /&gt;
 sudo apt-get install sugar-platform&lt;br /&gt;
&lt;br /&gt;
To use sugar-0.84 on 9.10(karmic)&lt;br /&gt;
 sudo sh -c &#039;echo deb http://ppa.launchpad.net/alsroot/ppa/ubuntu karmic main &amp;gt;&amp;gt; /etc/apt/sources.list&#039;&lt;br /&gt;
 sudo apt-get update&lt;br /&gt;
 sudo apt-get install sugar-platform&lt;br /&gt;
&lt;br /&gt;
To use sugar-0.86 on 9.10(karmic)&lt;br /&gt;
 sudo sh -c &#039;echo deb http://ppa.launchpad.net/alsroot/sugar-0.86/ubuntu karmic main &amp;gt;&amp;gt; /etc/apt/sources.list&#039;&lt;br /&gt;
 sudo apt-get update&lt;br /&gt;
 sudo apt-get install sugar-platform&lt;br /&gt;
&lt;br /&gt;
= ejabberd collaboration server on Ubuntu =&lt;br /&gt;
&lt;br /&gt;
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&lt;br /&gt;
&lt;br /&gt;
For Ubuntu 8.04 you need to build from source: http://wiki.laptop.org/go/Installing_ejabberd&lt;br /&gt;
&lt;br /&gt;
[[Category:Supported systems]]&lt;/div&gt;</summary>
		<author><name>Colin.applegate</name></author>
	</entry>
	<entry>
		<id>https://wiki.sugarlabs.org/index.php?title=Ubuntu&amp;diff=35373</id>
		<title>Ubuntu</title>
		<link rel="alternate" type="text/html" href="https://wiki.sugarlabs.org/index.php?title=Ubuntu&amp;diff=35373"/>
		<updated>2009-08-17T19:22:11Z</updated>

		<summary type="html">&lt;p&gt;Colin.applegate: /* Sugar on Ubuntu */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;{{TOCright}}&lt;br /&gt;
[[Image:Ubuntu.jpg]]&lt;br /&gt;
&lt;br /&gt;
= Sugar on Ubuntu =&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
It is a much simpler platform to set up for activity developers than jhbuild, although is not bleeding-edge.&lt;br /&gt;
&lt;br /&gt;
@the below:&lt;br /&gt;
I am building a package for 9.04 as we speak. should be done in a few days.&lt;br /&gt;
-Colin Applegate&lt;br /&gt;
&lt;br /&gt;
:{I might get flamed for this; I know I shouldn&#039;t post on a wiki like this, but no one will read the discussion: can we list a simple way of installing from jhbuild on Ubuntu 9.04 or installing from a PPA?  Is 0.83 in the Ubuntu sugar PPA recent enough?  How about installing from source (not git/jhbuild) and then adding an X session?  With Ubuntu being the most popular Linux distribution, it is in the interest of this project to flesh out these details.}&lt;br /&gt;
&lt;br /&gt;
Sugar on Ubuntu is packaged and maintained by the [https://wiki.ubuntu.com/SugarTeam Ubuntu Sugar team], who welcome new contributors to test, document, triage, and make packages.&lt;br /&gt;
&lt;br /&gt;
[https://launchpad.net/sugar Sugar bug reporting Ubuntu].&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Sugar on Ubuntu 9.04 (jaunty) ==&lt;br /&gt;
&lt;br /&gt;
Jaunty, the current Ubuntu release, has Sucrose 0.83 packages synced from [[Community/Distributions/Debian|Debian]].&lt;br /&gt;
&lt;br /&gt;
Sugar does not work out-of-the-box under Jaunty as of 2009-07-01, although there is a workaround. See the [[Talk:Community/Distributions/Ubuntu|discussion here]] for more information.&lt;br /&gt;
&lt;br /&gt;
:That work around doesn&#039;t work.--[[User:Dennis Daniels|Dennis Daniels]] 00:38, 7 August 2009 (UTC) &lt;br /&gt;
&lt;br /&gt;
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)&lt;br /&gt;
&lt;br /&gt;
=== Installing ===&lt;br /&gt;
&lt;br /&gt;
Installation instructions:&lt;br /&gt;
 sudo apt-get install sugar sugar-activities&lt;br /&gt;
&lt;br /&gt;
== Sugar on Ubuntu 8.10 (intrepid) ==&lt;br /&gt;
&lt;br /&gt;
Intrepid, the previous Ubuntu release, has Sucrose 0.82 packages synced from [[Community/Distributions/Debian|Debian]].&lt;br /&gt;
&lt;br /&gt;
=== Installing ===&lt;br /&gt;
&lt;br /&gt;
Installation instructions:&lt;br /&gt;
 sudo apt-get install sugar sugar-activities&lt;br /&gt;
&lt;br /&gt;
=== Running Sugar ===&lt;br /&gt;
&lt;br /&gt;
Run sugar in a window under a gnome login, using the Applications menu &amp;gt; Other &amp;gt; Sugar Emulator, or running the following in a terminal:&lt;br /&gt;
 sugar-emulator&lt;br /&gt;
&lt;br /&gt;
If everything is working fine, you can log into Sugar from the gdm login screen instead of running sugar-emulator.&lt;br /&gt;
&amp;lt;!--&lt;br /&gt;
The following does not currently work, but should in the future:&lt;br /&gt;
Some activities could not be included due to missing dependencies - notably Read and Write. These will be published in the [https://launchpad.net/~sugarteam/+archive Sugar Team PPA] soon, which can be accessed via&lt;br /&gt;
 sudo -s&lt;br /&gt;
 echo deb http://ppa.launchpad.net/sugarteam/ubuntu hardy main &amp;gt; /etc/apt/sources.list.d/sugar.list&lt;br /&gt;
 apt-get update &lt;br /&gt;
 apt-get install sugar sugar-emulator sugar-activities&lt;br /&gt;
--&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Upgrading ===&lt;br /&gt;
&lt;br /&gt;
If you are experiencing problems after upgrading from 8.04 (Hardy), please do the following to uninstall the partially-upgraded packages:&lt;br /&gt;
 sudo apt-get purge sugar sugar-\*&lt;br /&gt;
and repeat the installation command outlined above to install only the new packages.&lt;br /&gt;
&lt;br /&gt;
=== Reporting Bugs ===&lt;br /&gt;
&lt;br /&gt;
If you need log files for debugging, use the following command in a GNOME terminal &#039;&#039;(not Sugar Terminal)&#039;&#039; to run sugar with debug logs turned on:&lt;br /&gt;
 SUGAR_LOGGER_LEVEL=debug PRESENCESERVICE_DEBUG=1 sugar-emulator&lt;br /&gt;
&lt;br /&gt;
This generates log files in the .sugar/default/logs directory under your home directory.&lt;br /&gt;
&lt;br /&gt;
To report a bug on Sugar or one of the Sugar activities on Ubuntu, use the following steps:&lt;br /&gt;
* Go to https://launchpad.net/sucrose which represents all the Sugar components and activities supported in Ubuntu.&lt;br /&gt;
* Click on the appropriate component at the bottom of the page. If in doubt, click &amp;quot;Sugar shell&amp;quot; which is the base Sugar component.&lt;br /&gt;
* On the resulting page, scroll down to &amp;quot;Packages&amp;quot; and click on the hardy or intrepid package.&lt;br /&gt;
* On the resulting page, click on the &amp;quot;Bugs&amp;quot; tab at the top of the page.&lt;br /&gt;
* That takes you to a page listing known bugs on the package, and with a red &amp;quot;Report a bug&amp;quot; button.&lt;br /&gt;
&lt;br /&gt;
Please include any relevant log files in a bug report: activity log files usually are named similarly to &amp;quot;org.laptop.Chat-1.log&amp;quot; (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.&lt;br /&gt;
&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Please note&#039;&#039;&#039;: 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&#039;s [https://wiki.ubuntu.com/StableReleaseUpdates Stable Release Updates] process. Where possible we&#039;ll suggest a workaround, or provide a fix in the [https://launchpad.net/~sugarteam/+archive Sugar Team PPA] first.&lt;br /&gt;
&lt;br /&gt;
== Sugar on Ubuntu 8.04 LTS (hardy) ==&lt;br /&gt;
&lt;br /&gt;
hardy includes an old version of Sugar, 0.79. You can install the current stable release of Sugar, 0.82, with the instructions below.&lt;br /&gt;
&lt;br /&gt;
For bug reporting, please follow the instructions above as for intrepid.&lt;br /&gt;
&lt;br /&gt;
=== Sugar 0.79.0 ===&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Old, but included in Hardy&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
Sugar was packaged in Universe for Hardy (Ubuntu 8.04) by Jani Monoses. The version packaged is 0.79.0, similar to the version in OLPC Release 8.1.0.&lt;br /&gt;
&lt;br /&gt;
[http://janimo.blogspot.com/2008/02/sugar-finally-in-hardy-universe.html Installation instructions]&lt;br /&gt;
&lt;br /&gt;
There are extra packages in a [https://launchpad.net/~sugar/+archive/ PPA], including activities that could not be included in the Ubuntu archive due to license issues, as well as updated abiword packages.&lt;br /&gt;
&lt;br /&gt;
We do recommend using the version 0.82 packages instead, as mentioned below:&lt;br /&gt;
&lt;br /&gt;
=== Sucrose 0.82 ===&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Up-to-date version, extra repository&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
The Ubuntu packages were updated to the latest [[Development Team/Release/Releases/Sucrose/0.82|0.82]] point release in the [https://launchpad.net/~sugarteam/+archive Sugar Team PPA].&lt;br /&gt;
&lt;br /&gt;
Installation instructions:&lt;br /&gt;
 sudo -s&lt;br /&gt;
 echo deb http://ppa.launchpad.net/sugarteam/ubuntu hardy main &amp;gt; /etc/apt/sources.list.d/sugar.list&lt;br /&gt;
 apt-get update &lt;br /&gt;
 apt-get install sugar sugar-emulator sugar-activities&lt;br /&gt;
&lt;br /&gt;
Not working, tried it from Hardy Install 05/06/2009 [satellit]&lt;br /&gt;
&lt;br /&gt;
== Using sugar PPAs ==&lt;br /&gt;
&lt;br /&gt;
Another way to start sugar on Ubuntu is using sugar-* PPA.&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;NOTE&#039;&#039;&#039; These PPAs use packages generated by [[Deployment_Team/jhconvert|jhconvert]], so if you have sugar packages installed by another method you need to remove them all:&lt;br /&gt;
 sudo apt-get remove -f $(dpkg-query -l | grep -e sugar -e olpc | awk &#039;{print $2}&#039;)&lt;br /&gt;
&lt;br /&gt;
Before attaching ppa, load gpg key&lt;br /&gt;
 gpg --keyserver keyserver.ubuntu.com --recv F265806A9BFFF0F4&lt;br /&gt;
 gpg --export --armor F265806A9BFFF0F4 | sudo apt-key add -&lt;br /&gt;
&lt;br /&gt;
To use sugar-0.84 on 8.04(Hardy)&lt;br /&gt;
 sudo sh -c &#039;echo deb http://ppa.launchpad.net/alsroot/trisquel-edu/ubuntu hardy main &amp;gt;&amp;gt; /etc/apt/sources.list&#039;&lt;br /&gt;
 sudo apt-get update&lt;br /&gt;
 sudo apt-get install sugar-platform&lt;br /&gt;
&lt;br /&gt;
To use sugar-0.84 on 9.04(jaunty)&lt;br /&gt;
 sudo sh -c &#039;echo deb http://ppa.launchpad.net/alsroot/ppa/ubuntu jaunty main &amp;gt;&amp;gt; /etc/apt/sources.list&#039;&lt;br /&gt;
 sudo apt-get update&lt;br /&gt;
 sudo apt-get install sugar-platform&lt;br /&gt;
&lt;br /&gt;
To use sugar-0.84 on 9.10(karmic)&lt;br /&gt;
 sudo sh -c &#039;echo deb http://ppa.launchpad.net/alsroot/ppa/ubuntu karmic main &amp;gt;&amp;gt; /etc/apt/sources.list&#039;&lt;br /&gt;
 sudo apt-get update&lt;br /&gt;
 sudo apt-get install sugar-platform&lt;br /&gt;
&lt;br /&gt;
To use sugar-0.86 on 9.10(karmic)&lt;br /&gt;
 sudo sh -c &#039;echo deb http://ppa.launchpad.net/alsroot/sugar-0.86/ubuntu karmic main &amp;gt;&amp;gt; /etc/apt/sources.list&#039;&lt;br /&gt;
 sudo apt-get update&lt;br /&gt;
 sudo apt-get install sugar-platform&lt;br /&gt;
&lt;br /&gt;
= ejabberd collaboration server on Ubuntu =&lt;br /&gt;
&lt;br /&gt;
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&lt;br /&gt;
&lt;br /&gt;
For Ubuntu 8.04 you need to build from source: http://wiki.laptop.org/go/Installing_ejabberd&lt;br /&gt;
&lt;br /&gt;
[[Category:Supported systems]]&lt;/div&gt;</summary>
		<author><name>Colin.applegate</name></author>
	</entry>
</feed>