10,579
edits
Changes
no edit summary
<noinclude>{{ Translations | [[Downloads|english]] | [[Downloads/lang-es|español]] | [[Downloads/lang-fr|français]] | [[Downloads/lang-no|Norsk]] }}__NOEDITSECTION__</noinclude>
<noinclude>{{ Translations | [[Downloads|english]] | [[Downloads/lang-es|español]] | [[Downloads/lang-fr|français]] | [[Downloads/lang-no|Norsk]] }}__NOEDITSECTION__</noinclude>
{{:Sugar_on_a_Stick/Pancake page}}
{{:Downloads/Landing_page}}
__NOTOC__
=='''Are you a developer or Beta tester?'''==
<br/><br/>
==Are you new to Sugar?==
:Please select your favorite distribution below for instructions on installing 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. (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 ===
:[[File:Soas-mirabelle-logo.png|middle|200px|link=Sugar_on_a_Stick/Beta]], v4 alpha with Sugar 0.89.1 and Fedora 14 (Branched)
{|style="border: 0; border-width: 0;"
|-
|width="160px"|[[File:Windows.gif|left|link=Sugar on a Stick/Windows]]||valign=top|'''(1) Prepare''': [http://fedorahosted.org/liveusb-creator/#Download Download] the Fedora Live USB Creator from [http://fedorahosted.org/liveusb-creator/#Download FedoraHosted]
|-
|[[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.<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.
|}
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 users may want to install the [[#Do_you_use_GNU.2FLinux.3F|Sugar packages]] on their favorite distro.
{|
|-
|width="160px"|[[File:Gnulinux.png|link=Sugar on a Stick/Linux]]||valign=top|'''(1) Prepare''': Use this script http://bit.ly/livecd-iso-to-disk to create a bootable image. (Run {{Code|chmod +x livecd-iso-to-disk.sh}} after you download the script to make it executable.)
|-
|[[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''': Execute, as the root user, in <u>one</u> command with arguments, the following:<br>
{{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.
|-
| ||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.
|}
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 ===
'''DRAFT''': These instructions are incomplete. Please help with testing and documentation. In the meantime, 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.)
|-
|[[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: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.
* 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, [[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 ===
{|
|-
|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.
|}
<br/><br/>
==Do you have an OLPC XO?==
==Do you have an OLPC XO?==
:* Developers may experiment with [[Sugar_on_a_Stick/Installation/OLPC|Updating XOs]] to the latest ''Sugar on a Stick'' release.
{|
|-
|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
* '''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]]
* '''Experiment''' with [[Sugar_on_a_Stick/Installation/OLPC|Updating XOs]] to the latest ''Sugar on a Stick'' release.
|}
<br/><br/>
==Do you use GNU/Linux?==
==Are you looking for Sugar Activities?==
{|
:Please visit our dedicated [http://activities.sugarlabs.org Sugar Activity Library].
|-
|width="160px" valign="top"|Select your favorite distribution<br/>[[File:Gnulinux.png]]||
{|
|-
|[[Image:Fedora-small.jpg|link=Community/Distributions/Fedora]]<br/>[[Community/Distributions/Fedora|Fedora]]
|-
|[[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]
|-
|[[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
|}
<br/><br/>
== Virtual Machines on all platforms ==
{|
|-
| ||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].)
|-
|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
|-
| ||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.
|-
| ||'''[[Downloads|Other virtual machines]]''' may also work but have not undergone testing with our images.
|}
==Are you a systems developer?==
<br/><br/>
==Are you a developer?==
:Here are some additional references you may find useful:
{|
|-
|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...]]
|}
<br/><br/>
==Are you preparing a deployment without Internet access?==
==Are you preparing a deployment without Internet access?==
:See [[Sugar Creation Kit]].
{|
|-
|style="width: 160px"|[[File:Sugar Creation Kit.png|left|link=Sugar Creation Kit]]||valign="top"|See [[Sugar Creation Kit]]
|}
<br/><br/>
==Are you looking for Sugar Activities?==
{|
|-
|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>
|}