Difference between revisions of "User:Walter/Get Sugar"

From Sugar Labs
Jump to navigation Jump to search
m (→‎Apple OSX: update Macintosh link)
 
(81 intermediate revisions by 3 users not shown)
Line 1: Line 1:
__TOC__
+
{{Downloads/Get_Sugar_Landing}}
 +
__NOTOC__
  
 +
<br/><br/>
 
==Are you new to Sugar?==
 
==Are you new to Sugar?==
  
The easiest way to get started is to use [[Sugar on a Stick]]. Basic instructions are found below. A more detailed [http://download.sugarlabs.org/soas/docs/creation-kit/ Sugar-on-a-Stick Creation Guide] is also available.
+
The easiest way to get started is to use [[Sugar on a Stick]]. Basic instructions are found below. A more detailed [http://download.sugarlabs.org/soas/docs/creation-kit/ Sugar-on-a-Stick Creation Guide] is also available. (If you already use GNU/Linux, you may want to install the [[#Do_you_use_GNU.2FLinux.3F|Sugar packages]] available from your distro.)
 
+
----
 
=== MS Windows ===
 
=== MS Windows ===
  
Line 13: Line 15:
 
|[[File:Download Mirabell.png|left|link=http://spins.fedoraproject.org/soas/#downloads]]||valign=top|'''(2) Download''': [http://spins.fedoraproject.org/soas/#downloads Download] the Sugar-on-a-Stick iso.
 
|[[File:Download Mirabell.png|left|link=http://spins.fedoraproject.org/soas/#downloads]]||valign=top|'''(2) Download''': [http://spins.fedoraproject.org/soas/#downloads Download] the Sugar-on-a-Stick iso.
 
|-
 
|-
|[[File:USB flash drive.jpg|156px]]||valign=top|'''(3) Burn''': Insert a USB flash drive (or SD Card) with 1 GB or more of free space into your computer and launch Fedora Live USB Creator to create a Sugar-on-a-Stick bootable image.
+
|[[File:USB flash drive.jpg|156px]]||valign=top|'''(3) Burn''': Insert a USB flash drive (or SD Card) with 1 GB or more of free space into your computer and launch Fedora Live USB Creator to create a Sugar-on-a-Stick bootable image.<br/>'''Note''': Be sure to set the ''persistent storage'' slider to a non-zero value.
 
|-
 
|-
 
| ||valign=top|'''(4) Boot''': Insert the USB stick into a USB port on your computer. Set the option to "boot from USB" in your computer's BIOS, and then start up the computer.
 
| ||valign=top|'''(4) Boot''': Insert the USB stick into a USB port on your computer. Set the option to "boot from USB" in your computer's BIOS, and then start up the computer.
Line 19: Line 21:
  
 
Detailed [[Sugar on a Stick/Windows|installation instructions for Windows]] and [[Sugar on a Stick/Boot|booting instructions]] are available. There is also a [[Sugar on a Stick/Usage|guide to using Sugar on a Stick]].
 
Detailed [[Sugar on a Stick/Windows|installation instructions for Windows]] and [[Sugar on a Stick/Boot|booting instructions]] are available. There is also a [[Sugar on a Stick/Usage|guide to using Sugar on a Stick]].
 
+
----
 
=== GNU/Linux ===
 
=== GNU/Linux ===
GNU/Linux users may want to install the [[#Do_you_use_a_GNU.2FLinux_distro.3F|Sugar packages]] on their favorite distro.
+
GNU/Linux users may want to install the [[#Do_you_use_GNU.2FLinux.3F|Sugar packages]] on their favorite distro.
  
 
{|
 
{|
Line 30: Line 32:
 
|-
 
|-
 
|[[File:USB flash drive.jpg|156px]]||valign=top|'''(3) Burn''': Execute, as the root user, in <u>one</u> command with arguments, the following:<br>
 
|[[File:USB flash drive.jpg|156px]]||valign=top|'''(3) Burn''': Execute, as the root user, in <u>one</u> command with arguments, the following:<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{{Code|./livecd-iso-to-disk.sh --format --reset-mbr --overlay-size-mb 200 --home-size-mb 200 --delete-home --unencrypted-home /path/to/source.iso /dev/sd'''?'''1}}<br>
+
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{{Code|./livecd-iso-to-disk.sh --reset-mbr --overlay-size-mb 200 --home-size-mb 200 --delete-home --unencrypted-home /path/to/source.iso /dev/sd'''?'''1}}<br>
 
: where '{{Code|'''?'''}}' in the final parameter represents the target bootable device node, such as {{Code|sdb1}} or {{Code|sdc1}}, etc.
 
: where '{{Code|'''?'''}}' in the final parameter represents the target bootable device node, such as {{Code|sdb1}} or {{Code|sdc1}}, etc.
 
|-
 
|-
Line 37: Line 39:
  
 
Detailed [[Sugar on a Stick/Linux|installation instructions for GNU/Linux]] and [[Sugar on a Stick/Boot|booting instructions]] are available. There is also a [[Sugar on a Stick/Usage|guide to using Sugar on a Stick]].
 
Detailed [[Sugar on a Stick/Linux|installation instructions for GNU/Linux]] and [[Sugar on a Stick/Boot|booting instructions]] are available. There is also a [[Sugar on a Stick/Usage|guide to using Sugar on a Stick]].
 
+
----
 
=== Apple OSX ===
 
=== Apple OSX ===
'''DRAFT'''
+
'''DRAFT''': These instructions are incomplete. Please help with testing and documentation. You may want to refer to the '''[[#Virtual Machines on all platforms|Virtual Machines instructions]]''' below.
 
{|
 
{|
 
|-
 
|-
|width="160px"|[[File:Apple.gif|link=Sugar_on_a_Stick/Mac]]||valign=top|'''(1) Prepare''': These instructions are only for '''64-bit''' machines. (To identify processor, choose Apple menu > About This Mac. A small window will appear titled ''About This Mac''. The processor type is displayed in this window. Sugar on a Stick is for the Intel processor only.) You may want to refer to the [[#Virtual Machines on all platforms|Virtual Machines instructions]] below.
+
|width="160px"|[[File:Apple.gif|link=Macintosh]]||valign=top|'''(1) Prepare''': These instructions are only for '''64-bit''' machines. (To identify processor, choose Apple menu > About This Mac. A small window will appear titled ''About This Mac''. The processor type is displayed in this window. Sugar on a Stick is for the Intel processor only.)
 
|-
 
|-
 
|[[File:Download Mirabell.png|left|link=http://spins.fedoraproject.org/soas/#downloads]]||valign=top|'''(2) Download''': [http://spins.fedoraproject.org/soas/#downloads Download] the Sugar-on-a-Stick iso. Be sure to download a '''64-bit''' image.
 
|[[File:Download Mirabell.png|left|link=http://spins.fedoraproject.org/soas/#downloads]]||valign=top|'''(2) Download''': [http://spins.fedoraproject.org/soas/#downloads Download] the Sugar-on-a-Stick iso. Be sure to download a '''64-bit''' image.
Line 48: Line 50:
 
|[[File:USB flash drive.jpg|156px]]||valign=top|'''(3) Burn''': '''Does someone have a simple way to burn a Live USB on a Mac?'''
 
|[[File:USB flash drive.jpg|156px]]||valign=top|'''(3) Burn''': '''Does someone have a simple way to burn a Live USB on a Mac?'''
 
|-
 
|-
| ||valign=top|'''(4) Boot''': Insert the USB stick into a USB port on your computer. '''Is this correct?''': During the startup sound, press and hold the '''c''' key. If the Apple logo appears, Sugar is not booting. Restart and try again.<br/>&nbsp;• the '''c''' key must be pressed during the startup sound and you must continue to hold it down.<br/>&nbsp;• you may release the '''c''' key once the Sugar logo appears.  
+
| ||valign=top|'''(4) Boot''': Insert the USB stick into a USB port on your computer. '''Is this correct?''': During the startup sound, press and hold the '''c''' key. If the Apple logo appears, Sugar is not booting. Restart and try again.
 +
* the '''c''' key must be pressed during the startup sound and you must continue to hold it down.
 +
* you may release the '''c''' key once the Sugar logo appears.  
 
|}
 
|}
  
Alternative [[Sugar on a Stick/Mac|installation instructions for OSX]] Also:[http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/Blueberry#For_Mac_OS_X_Users] and [[Sugar on a Stick/Boot|booting instructions]] are available. There is also a [[Sugar on a Stick/Usage|guide to using Sugar on a Stick]].
+
Alternative [[Macintosh|installation instructions for OSX]] Also, [[Sugar_on_a_Stick/Blueberry#For_Mac_OS_X_Users|these older installation instructions]] and [[Sugar on a Stick/Boot|booting instructions]] are available. There is also a [[Sugar on a Stick/Usage|guide to using Sugar on a Stick]].
 +
----
  
 
=== Advanced users ===
 
=== Advanced users ===
Line 57: Line 62:
 
{|
 
{|
 
|-
 
|-
|style="width: 160px;"|[[File:Sugar Creation Kit.png]]||valign=top|&nbsp;• '''Explore''' the [[Sugar_Creation_Kit]]<br/>&nbsp;• '''Try''' [[Sugar_on_a_Stick/Installation/Variations|customizing]] Sugar on a Stick;<br/>&nbsp;• '''Read''' the [http://download.sugarlabs.org/soas/docs/customization-guide/ detailed Customization Guide]; and<br/>&nbsp;• '''Read''' additional instructions for using [[VirtualBox]] and other virtual machines.
+
|style="width: 160px;"|[[File:Sugar Creation Kit.png]]||valign=top|
 +
* '''Explore''' the [[Sugar Creation Kit]]
 +
* '''Try''' [[Sugar_on_a_Stick/Installation/Variations|customizing]] Sugar on a Stick;
 +
* '''Read''' the [http://download.sugarlabs.org/soas/docs/customization-guide/ detailed Customization Guide]; and
 +
* '''Read''' additional instructions for using [[VirtualBox]] and other virtual machines.
 
|}
 
|}
  
== Virtual Machines on all platforms ==
+
<br/><br/>
 +
==Do you have an OLPC XO?==  
  
 
{|
 
{|
 
|-
 
|-
| ||valign=top|'''(1) Prepare''': [http://www.virtualbox.org/wiki/Downloads Download] Sun Virtualbox (It is recommended that you read [http://people.sugarlabs.org/Tgillard/soas-v3-MirabelleREADME_FIRST.txt README_FIRST] before starting.)
+
|style="width: 160px"|[[Image:OLPCXO.png|middle|link=Dextrose]]||<!-- valign="top"|[[File:Dextrose-py-692x96.png|346px|link=Dextrose]]-->
|-
+
* '''Upgrade''' to [[Deployment_Team/Fedora_on_the_XO-1 |Sugar 0.84 with Fedora 11 and Gnome]], the ''[http://wiki.laptop.org/go/OS_images#Stable_builds stable]'' OLPC release
|width="160px"|[[File:VirtualBox.png|100px|left]]||valign=top|'''(2) Download''': Download these three files:<br/>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[http://people.sugarlabs.org/Tgillard/soas-v3-Mirabelle.mf soas-v3-Mirabelle.mf]<br/>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[http://people.sugarlabs.org/Tgillard/soas-v3-Mirabelle.ovf soas-v3-Mirabelle.ovf]<br/>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[http://people.sugarlabs.org/Tgillard/soas-v3-Mirabelle.vmdk soas-v3-Mirabelle.vmdk]<br/>Note that on some browsers on OSX, the file extensions are reset upon download. You may have to modify them to match those shown above.<br/>'''sugarroot''' is the root password.
+
* '''Upgrade''' to [[Dextrose |Dextrose Sugar 0.88 with Fedora 11 and Gnome]] (requires a ''[http://wiki.laptop.org/go/Activation_and_developer_keys developer key]'')
|-
+
* '''Load ''' another one of the [[OLPC:OS images]]
| ||valign=top|'''(3) Launch''': Virtualbox
+
* '''Experiment''' with [[Sugar_on_a_Stick/Installation/OLPC|Updating XOs]] to the latest ''Sugar on a Stick'' release.
|-
 
| ||valign=top|'''(4) Import''': soas-v3-Mirabelle.ovf from the ''Import Appliance'' option under the ''File'' menu.
 
 
|}
 
|}
  
Other virtual machine may also work but have not undergone testing with our images.
+
<br/><br/>
  
==Do you have an OLPC XO?==  
+
==Do you use GNU/Linux?==
  
 
{|
 
{|
 
|-
 
|-
|style="width: 160px"|[[Image:OLPCXO.png|middle|link=Dextrose]]||valign="top"|[[File:Dextrose-py-692x96.png|346px|link=Dextrose]]<br/>&nbsp;• '''Upgrade''' to [[Dextrose |Sugar 0.88 with Fedora 11 and Gnome]]
+
|width="160px" valign="top"|Select your favorite distribution<br/>[[File:Gnulinux.png]]||
 +
{|
 
|-
 
|-
| ||&nbsp;• '''Upgrade''' to [[Deployment_Team/Fedora_on_the_XO-1 |Sugar 0.84 with Fedora 11 and Gnome]].
+
|[[Image:Fedora-small.jpg|link=Community/Distributions/Fedora]]<br/>[[Community/Distributions/Fedora|Fedora]]
 
|-
 
|-
| ||&nbsp;• '''Load ''' one of the [[OLPC:OS images]]
+
|[[Image:Debian-small.jpg|link=Community/Distributions/Debian]]<br/>[[Community/Distributions/Debian|Debian]]||[[Image:Trisquel_icon.png|link=Community/Distributions/Trisquel]]<br/>[[Community/Distributions/Trisquel|Trisquel]]||[[Image:Ubuntu-small.jpg|link=Community/Distributions/Ubuntu]]<br/>[[Community/Distributions/Ubuntu|Ubuntu]]||[[Image:Ubuntu-small.jpg|link=https://wiki.ubuntu.com/Sugar]]<br/>[https://wiki.ubuntu.com/Sugar Ubuntu Sugar Remix]
 
|-
 
|-
| ||&nbsp;• '''Experiment''' with [[Sugar_on_a_Stick/Installation/OLPC|Updating XOs]] to the latest ''Sugar on a Stick'' release.
+
|[[Image:Mandriva-small.png|link=Community/Distributions/Mandriva]]<br/>[[Community/Distributions/Mandriva|Mandriva]]||[[Image:Caixa_M%C3%A1gica-small.jpg|link=Community/Distributions/Magalhães]]<br/>[[Community/Distributions/Magalhães|Caixa Mágica]]
 +
|-
 +
|[[Image:Suse-small.jpg|link=http://en.opensuse.org/Sugar]]<br/>[http://en.opensuse.org/Sugar OpenSuse]||
 +
|-
 +
|[[Image:Altlinux-small.png|link=Community/Distributions/ALTLinux]]<br/>[[Community/Distributions/ALTLinux|AltLinux]]
 +
|-
 +
|[[Image:Gentoo-small.png|link=Community/Distributions/Gentoo]]<br/>[[Community/Distributions/Gentoo|Gentoo]]
 +
|}
 +
|-
 +
|valign="top"|Or try a Live USB version of Sugar||[[File:Soas-mirabelle-logo.png|middle|200px|link=Sugar_on_a_Stick/Beta]], v4 alpha with Sugar 0.89.1 and Fedora 14 (Branched)<br/>[[Image:Trisquel_icon.png|link=Trisquel On A Sugar Toast]] Trisquel on a Sugar Toast (Trisquel 3.0 ''Dwyn'')<br/>[[Image:Suse-small.jpg|link=http://en.opensuse.org/Education/Live|Education/Live]] OpenSuse Live USB
 
|}
 
|}
  
==Do you use a GNU/Linux distro?==
+
<br/><br/>
 +
== Virtual Machines on all platforms ==
  
 
{|
 
{|
 
|-
 
|-
|style="width: 160px; valign: top" align="right"|Select your favorite distribution||
+
| ||valign=top|'''(1) Prepare''': [http://www.virtualbox.org/wiki/Downloads Download] Sun VirtualBox (It is recommended that you [http://people.sugarlabs.org/Tgillard/soas-v3-MirabelleREADME_FIRST.txt read this first].)
{|
 
 
|-
 
|-
|[[Image:Fedora-small.jpg|link=Community/Distributions/Fedora]]<br/>[[Community/Distributions/Fedora|Fedora]]||[[Image:Ubuntu-small.jpg|link=Community/Distributions/Ubuntu]]<br/>[[Community/Distributions/Ubuntu|Ubuntu]]||[[Image:Ubuntu-small.jpg|link=https://wiki.ubuntu.com/Sugar]]<br/>[https://wiki.ubuntu.com/Sugar Ubuntu<br/>Sugar Remix]
+
|width="160px"|[[File:VirtualBox.png|100px|left]]||valign=top|'''(2) Download''': Download these three files:
 +
::[http://people.sugarlabs.org/Tgillard/soas-v3-Mirabelle.mf soas-v3-Mirabelle.mf]
 +
::[http://people.sugarlabs.org/Tgillard/soas-v3-Mirabelle.ovf soas-v3-Mirabelle.ovf]
 +
::[http://people.sugarlabs.org/Tgillard/soas-v3-Mirabelle.vmdk soas-v3-Mirabelle.vmdk]
 +
:Note that on some browsers on OSX, the file extensions are reset upon download. You may have to modify them to match those shown above.
 +
:'''sugarroot''' is the root password.
 +
|-
 +
| ||valign=top|'''(3) Launch''': VirtualBox
 
|-
 
|-
|[[Image:Debian-small.jpg|link=Community/Distributions/Debian]]<br/>[[Community/Distributions/Debian|Debian]]||[[Image:Gentoo-small.png|link=Community/Distributions/Gentoo]]<br/>[[Community/Distributions/Gentoo|Gentoo]]||[[Image:Altlinux-small.png|link=Community/Distributions/ALTLinux]]<br/>[[Community/Distributions/ALTLinux|AltLinux]]
+
| ||valign=top|'''(4) Import''': soas-v3-Mirabelle.ovf from the ''Import Appliance'' option under the ''File'' menu.
 +
:If you run into problems, you may want to consult the [[Talk:VirtualBox]] page for help.
 
|-
 
|-
|[[Image:Mandriva-small.png|link=Community/Distributions/Mandriva]]<br/>[[Community/Distributions/Mandriva|Mandriva]]||[[Image:Caixa_M%C3%A1gica-small.jpg|link=Community/Distributions/Magalhães]]<br/>[[Community/Distributions/Magalhães|Caixa_M%C3%A1gica]]||[[Image:Trisquel_icon.png|link=Community/Distributions/Trisquel]]<br/>[[Community/Distributions/Trisquel|Trisquel]]
+
| ||'''[[User_talk:Walter/Get_Sugar|Other virtual machines]]''' may also work but have not undergone testing with our images.
|-
+
 
|[[Image:Suse-small.jpg|link=http://en.opensuse.org/Sugar]]<br/>[http://en.opensuse.org/Sugar OpenSuse]
 
|}
 
|-
 
|valign="top" align="right"|Or try a Live USB version of Sugar||[[File:Soas-mirabelle-logo.png|middle|200px|link=Sugar_on_a_Stick/Beta]], v4 alpha with Sugar 0.89.1 and Fedora 14 (Branched)<br/>[[Image:Trisquel_icon.png|link=Trisquel On A Sugar Toast]] Trisquel on a Sugar Toast (Trisquel 3.0 ''Dwyn'')
 
 
|}
 
|}
  
==Are you looking for Sugar Activities?==
+
<br/><br/>
 +
==Are you a developer?==
 +
 
 
{|
 
{|
 
|-
 
|-
|width="160px" valign="top" align="right"|Visit the [http://activities.sugarlabs.org Activity Portal]||[[Image:Sugarlabs_mainpage_02.png|link=http://activities.sugarlabs.org]]
+
|style="width: 160px"| ||valign=top|Learn how to get setup on the [[Supported systems]] page.
 +
|-
 +
|[[Image:Gear.png|middle|link=Supported_systems]]||valign=top|Some additional references you may find useful:
 +
* [[Development Team/Jhbuild | jhbuild]]
 +
* [http://git.sugarlabs.org Gitorious source code repository]
 +
* [[Emulator image files|Virtual machine or emulator image files]]
 +
* Adding Sugar to your [[Supported systems|favorite distro...]]
 
|}
 
|}
  
==Are you a systems developer?==
+
<br/><br/>
 +
==Are you preparing a deployment without Internet access?==
 +
 
 
{|
 
{|
 
|-
 
|-
|style="width: 160px"|[[Image:Gear.png|middle|link=Supported_systems]]||valign=top|Learn how to get setup on the [[Supported systems]] page.
+
|style="width: 160px"|[[File:Sugar Creation Kit.png|left|link=Sugar Creation Kit]]||valign="top"|See [[Sugar Creation Kit]]
|-
 
| ||valign=top|Some additional references you may find useful:<br/>&nbsp;• [[Development Team/Jhbuild | jhbuild]]<br/>&nbsp;• [http://git.sugarlabs.org Gitorious source code repository]<br/>&nbsp;• [[Emulator image files|Virtual machine or emulator image files]]<br/>&nbsp;• Adding Sugar to your [[Supported systems|favorite distro...]]
 
 
|}
 
|}
  
==Are you preparing a deployment without Internet access?==
+
<br/><br/>
 +
 
 +
==Are you looking for Sugar Activities?==
  
 
{|
 
{|
 
|-
 
|-
|style="width: 160px"|[[File:Sugar Creation Kit.png|left|link=Sugar Creation Kit]]||valign="top"|See [[Sugar Creation Kit]]
+
|width="160px" valign="top"|Visit the [http://activities.sugarlabs.org Sugar Activity Library]||<imagemap>
 +
File:Sugarlabs_mainpage_02.png
 +
rect 14 14 38 47 [[sal:4076|Calculate]]
 +
rect 74 15 107 44 [[sal:4069|Chat]]
 +
rect 137 16 171 43 [[sal:4086|Implode]]
 +
rect 201 14 238 46 [[sal:4264|Distance]]
 +
rect 265 12 298 47 [[sal:4030|Etoys]]
 +
rect 11 79 41 108 [[sal:4034|Moon]]
 +
rect 74 78 106 110 [[sal:4082|Paint]]
 +
rect 140 78 170 109 [[sal:4041|Pippy]]
 +
rect 201 80 235 108 [[sal:4028|Read]]
 +
rect 266 82 298 107 [[sal:4081|Record]]
 +
rect 11 143 41 172 [[sal:4062|TamTam Synth Lab]]
 +
rect 75 146 105 169 [[sal:4043|Terminal]]
 +
rect 142 140 166 173 [[sal:4027|Turtle Blocks]]
 +
rect 201 144 235 171 [[olpc:WikiBrowse|WikiBrowse]]
 +
rect 269 142 299 173 [[sal:4201|Write]]
 +
default [http://activities.sugarlabs.org Sugar Activity Library]
 +
desc none
 +
</imagemap>
 
|}
 
|}

Latest revision as of 21:09, 30 June 2012

Template:Downloads/Get Sugar Landing




Are you new to Sugar?

The easiest way to get started is to use Sugar on a Stick. Basic instructions are found below. A more detailed Sugar-on-a-Stick Creation Guide is also available. (If you already use GNU/Linux, you may want to install the Sugar packages available from your distro.)


MS Windows

Windows.gif
(1) Prepare: Download the Fedora Live USB Creator from FedoraHosted
Download Mirabell.png
(2) Download: Download the Sugar-on-a-Stick iso.
USB flash drive.jpg (3) Burn: Insert a USB flash drive (or SD Card) with 1 GB or more of free space into your computer and launch Fedora Live USB Creator to create a Sugar-on-a-Stick bootable image.
Note: Be sure to set the persistent storage slider to a non-zero value.
(4) Boot: Insert the USB stick into a USB port on your computer. Set the option to "boot from USB" in your computer's BIOS, and then start up the computer.

Detailed installation instructions for Windows and booting instructions are available. There is also a guide to using Sugar on a Stick.


GNU/Linux

GNU/Linux users may want to install the Sugar packages on their favorite distro.

Gnulinux.png (1) Prepare: Use this script http://bit.ly/livecd-iso-to-disk to create a bootable image. (Run chmod +x livecd-iso-to-disk.sh after you download the script to make it executable.)
Download Mirabell.png
(2) Download: Download the Sugar-on-a-Stick iso.
USB flash drive.jpg (3) Burn: Execute, as the root user, in one command with arguments, the following:

      ./livecd-iso-to-disk.sh --reset-mbr --overlay-size-mb 200 --home-size-mb 200 --delete-home --unencrypted-home /path/to/source.iso /dev/sd?1

where '?' in the final parameter represents the target bootable device node, such as sdb1 or sdc1, etc.
(4) Boot: Insert the USB stick into a USB port on your computer. Set the option to "boot from USB" in your computer's BIOS, and then start up the computer.

Detailed installation instructions for GNU/Linux and booting instructions are available. There is also a guide to using Sugar on a Stick.


Apple OSX

DRAFT: These instructions are incomplete. Please help with testing and documentation. You may want to refer to the Virtual Machines instructions below.

Apple.gif (1) Prepare: These instructions are only for 64-bit machines. (To identify processor, choose Apple menu > About This Mac. A small window will appear titled About This Mac. The processor type is displayed in this window. Sugar on a Stick is for the Intel processor only.)
Download Mirabell.png
(2) Download: Download the Sugar-on-a-Stick iso. Be sure to download a 64-bit image.
USB flash drive.jpg (3) Burn: Does someone have a simple way to burn a Live USB on a Mac?
(4) Boot: Insert the USB stick into a USB port on your computer. Is this correct?: During the startup sound, press and hold the c key. If the Apple logo appears, Sugar is not booting. Restart and try again.
  • the c key must be pressed during the startup sound and you must continue to hold it down.
  • you may release the c key once the Sugar logo appears.

Alternative installation instructions for OSX Also, these older installation instructions and booting instructions are available. There is also a guide to using Sugar on a Stick.


Advanced users

Sugar Creation Kit.png



Do you have an OLPC XO?

OLPCXO.png



Do you use GNU/Linux?

Select your favorite distribution
Gnulinux.png
Fedora-small.jpg
Fedora
Debian-small.jpg
Debian
Trisquel icon.png
Trisquel
Ubuntu-small.jpg
Ubuntu
Ubuntu-small.jpg
Ubuntu Sugar Remix
Mandriva-small.png
Mandriva
Caixa Mágica-small.jpg
Caixa Mágica
Suse-small.jpg
OpenSuse
Altlinux-small.png
AltLinux
Gentoo-small.png
Gentoo
Or try a Live USB version of Sugar Soas-mirabelle-logo.png, v4 alpha with Sugar 0.89.1 and Fedora 14 (Branched)
Trisquel icon.png Trisquel on a Sugar Toast (Trisquel 3.0 Dwyn)
Education/Live OpenSuse Live USB



Virtual Machines on all platforms

(1) Prepare: Download Sun VirtualBox (It is recommended that you read this first.)
VirtualBox.png
(2) Download: Download these three files:
soas-v3-Mirabelle.mf
soas-v3-Mirabelle.ovf
soas-v3-Mirabelle.vmdk
Note that on some browsers on OSX, the file extensions are reset upon download. You may have to modify them to match those shown above.
sugarroot is the root password.
(3) Launch: VirtualBox
(4) Import: soas-v3-Mirabelle.ovf from the Import Appliance option under the File menu.
If you run into problems, you may want to consult the Talk:VirtualBox page for help.
Other virtual machines may also work but have not undergone testing with our images.



Are you a developer?

Learn how to get setup on the Supported systems page.
Gear.png Some additional references you may find useful:



Are you preparing a deployment without Internet access?

Sugar Creation Kit.png
See Sugar Creation Kit



Are you looking for Sugar Activities?

Visit the Sugar Activity Library <imagemap>

File:Sugarlabs_mainpage_02.png rect 14 14 38 47 Calculate rect 74 15 107 44 Chat rect 137 16 171 43 Implode rect 201 14 238 46 Distance rect 265 12 298 47 Etoys rect 11 79 41 108 Moon rect 74 78 106 110 Paint rect 140 78 170 109 Pippy rect 201 80 235 108 Read rect 266 82 298 107 Record rect 11 143 41 172 TamTam Synth Lab rect 75 146 105 169 Terminal rect 142 140 166 173 Turtle Blocks rect 201 144 235 171 WikiBrowse rect 269 142 299 173 Write default Sugar Activity Library desc none </imagemap>