Difference between revisions of "Downloads"

Revision as of 18:50, 21 September 2010

HowTo [ID# 57302]

File:Download-circle.png rect 58 6 109 51 MS Windows rect 146 28 195 85 GNU/Linux rect 146 128 200 181 OLPC XO rect 60 154 111 212 virtual machine rect 5 77 50 133 Apple Mac OS X rect 86 76 128 133 Are you new to Sugar? desc none </imagemap>

Are you looking for instructions on how to install Sugar on a Stick? (English), (en español)
Are you new to Sugar? [MS Windows] [GNU/Linux] [Apple Mac OS X] [advanced users]
Do you have an OLPC XO?
Do you use GNU/Linux?
Do you use a virtual machine?
Are you a developer?
Are you preparing a deployment without Internet access?
Are you looking for Sugar Activities?

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

Prepare: Download the Fedora Live USB Creator from FedoraHosted
Download: Download the Sugar-on-a-Stick iso.
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.
Boot: Insert the USB stick into a USB port on your computer. Set the option to "boot from USB" in your computer's BIOS setup, 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.

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: Download the Sugar-on-a-Stick iso.
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.
Boot: Insert the USB stick into a USB port on your computer. Set the option to "boot from USB" in your computer's BIOS setup, 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 Mac OS X

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

Prepare: These instructions are only for 64-bit processor machines. (To identify the processor type, 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: Download the Sugar-on-a-Stick iso. Be sure to download a 64-bit image.
Burn: Help, Does someone have a simple way to burn a Live USB on a Mac?
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

Explore the Sugar Creation Kit

Try customizing Sugar on a Stick;

Read the detailed Customization Guide; and

Read additional instructions for using VirtualBox and other virtual machines.

Do you have an OLPC XO?

Upgrade to Sugar 0.84 with Fedora 11 and Gnome, the stable OLPC release

Upgrade to Dextrose Sugar 0.88 with Fedora 11 and Gnome (requires a developer key)

Load another one of the OLPC:OS images

Experiment with Updating XOs to the latest Sugar on a Stick release.

Do you use GNU/Linux?

Select your favorite distribution

Fedora
Debian	Trisquel	Ubuntu	Ubuntu Sugar Remix
Mandriva	Caixa Mágica
OpenSuse
AltLinux
Gentoo

Or try a Live USB version of Sugar

, v4 beta with Sugar 0.89.9 and Fedora 14 (Laughlin)

Trisquel on a Sugar Toast (Trisquel 3.0 Dwyn)

OpenSuse Live USB

Virtual Machines on all platforms

Prepare: Download Sun VirtualBox (It is recommended that you read this first.)
Download: Download these three files:
soas-v3-Mirabelle.mf

soas-v3-Mirabelle.ovf

soas-v3-Mirabelle.vmdk

(Note that on some browsers on Mac OS X, the file extensions are reset upon download. You may have to modify them to match those shown above.)

sugarroot is the root password.
Launch: VirtualBox
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.

Some additional references you may find useful:

Are you preparing a deployment without Internet access?

See Sugar Creation Kit

Are you looking for Sugar Activities?

Visit the Sugar Activity Library

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>

@@ Line 10: / Line 10: @@
 === MS Windows ===
-{|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.
+|width="160px" valign="top"|[[File:Windows.gif|left|link=Sugar on a Stick/Windows]]
+<br><br><br>
+[[File:Download Mirabell.png|left|link=http://spins.fedoraproject.org/soas/#downloads]]
+[[File:USB flash drive.jpg|left|156px|link=http://spins.fedoraproject.org/soas/#downloads]]
+|valign=top|
+# '''Prepare''': [http://fedorahosted.org/liveusb-creator/#Download Download] the Fedora Live USB Creator from [http://fedorahosted.org/liveusb-creator/#Download FedoraHosted]<br><br>
+# '''Download''': [http://spins.fedoraproject.org/soas/#downloads Download] the Sugar-on-a-Stick iso.<br><br>
+# '''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.<br><br>
+# '''Boot''': Insert the USB stick into a USB port on your computer. Set the option to "boot from USB" in your computer's <abbr title="Basic Input/Output System">BIOS</abbr> setup, and then start up the computer.
 |}
@@ Line 28: / Line 30: @@
 {|
 |-
-|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.)
+|width="160px"|[[File:Gnulinux.png|link=Sugar on a Stick/Linux]]
-|-
+<br>
-|[[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]]
-|-
+[[File:USB flash drive.jpg|156px|link=http://spins.fedoraproject.org/soas/#downloads]]
-|[[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>
+|valign=top|
-&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>
+# '''Prepare''': Use this script http://bit.ly/livecd-iso-to-disk to create a bootable image.<br>(Run {{Code|chmod +x livecd-iso-to-disk.sh}} after you download the script to make it executable.)<br><br>
-: where '{{Code|'''?'''}}' in the final parameter represents the target bootable device node, such as {{Code|sdb1}} or {{Code|sdc1}}, etc.
+# '''Download''': [http://spins.fedoraproject.org/soas/#downloads Download] the Sugar-on-a-Stick iso.<br><br>
-|-
+# '''Burn''': Execute, as the root user, in <u>one</u> command with arguments, the following:
-| ||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.
+#:{{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}}
+#: where '{{Code|'''?'''}}' in the final parameter represents the target bootable device node, such as {{Code|sdb1}} or {{Code|sdc1}}, etc.<br><br>
+# '''Boot''': Insert the USB stick into a USB port on your computer. Set the option to "boot from USB" in your computer's <abbr title="Basic Input/Output System">BIOS</abbr> setup, and then start up the computer.
 |}
@@ Line 45: / Line 49: @@
 {|
 |-
-|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.)
+|width="160px" valign="top"|[[File:Apple.gif|link=Sugar_on_a_Stick/Mac]]
-|-
+<br>
-|[[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]]
-|-
+[[File:USB flash drive.jpg|156px|link=http://spins.fedoraproject.org/soas/#downloads]]
-|[[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|
-|-
+# '''Prepare''': These instructions are only for '''64-bit''' processor machines. (To identify the processor type, 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.)<br><br>
-| ||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.
+# '''Download''': [http://spins.fedoraproject.org/soas/#downloads Download] the Sugar-on-a-Stick iso. Be sure to download a '''64-bit''' image.<br><br>
-* the '''c''' key must be pressed during the startup sound and you must continue to hold it down.
+# '''Burn''': <span style="background-color:#f9f6b7; border: 1px solid #c4c295; padding: 10px; padding-left: 5px;">[[File:question.png]] '''Help, Does someone have a simple way to burn a Live USB on a Mac?'''</span><br><br>
-* you may release the '''c''' key once the Sugar logo appears.
+# '''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.
 |}
@@ Line 62: / Line 68: @@
 {|
 |-
-|style="width: 160px;"|[[File:Sugar Creation Kit.png]]||valign=top|
+|width="174px"|[[File:Sugar Creation Kit.png|link=Sugar Creation Kit]]
+|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.
 |}
@@ Line 74: / Line 87: @@
 {|
 |-
-|style="width: 160px"|[[Image:OLPCXO.png|middle|link=Dextrose]]||<!-- valign="top"|[[File:Dextrose-py-692x96.png|346px|link=Dextrose]]-->
+|width="174px"|[[File:OLPCXO.png|middle|link=Dextrose]]
+|valign=top|
 * '''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.
 |}
@@ Line 87: / Line 104: @@
 {|
 |-
-|width="160px" valign="top"|Select your favorite distribution<br/>[[File:Gnulinux.png]]||
+|width="178px" valign="top"|Select your favorite distribution<br><br>[[File:Gnulinux.png|link=Community/Distributions]]||
 {|
 |-
 |[[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: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]]||&nbsp;&nbsp;&nbsp;&nbsp;[[Image:Ubuntu-small.jpg|link=http://wiki.ubuntu.com/Sugar]]<br>[http://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]]
@@ Line 103: / Line 120: @@
 |}
 |-
-|valign="top"|Or try a Live USB version of Sugar||[[File:Soas-mirabelle-logo.png|middle|200px|link=Sugar_on_a_Stick/Beta]], v4 beta with Sugar 0.89.9 and Fedora 14 (Laughlin)<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
+|width="180px" valign="top"|Or try a Live USB version of Sugar
+|[[File:Soas-mirabelle-logo.png|middle|200px|link=Sugar_on_a_Stick/Beta]], v4 beta with Sugar 0.89.9 and Fedora 14 (Laughlin)<br/>[[File:Trisquel_icon.png|link=Trisquel On A Sugar Toast]] Trisquel on a Sugar Toast (Trisquel 3.0 ''Dwyn'')<br/>[[File:Suse-small.jpg|link=http://en.opensuse.org/Education/Live|Education/Live]] OpenSuse Live USB
 |}
@@ Line 111: / Line 129: @@
 {|
 |-
-| ||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|link=http://www.virtualbox.org/wiki/Downloads]]
-|-
+|valign=top|
-|width="160px"|[[File:VirtualBox.png|100px|left]]||valign=top|'''(2) Download''': Download these three files:
+# '''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].)
-::[http://people.sugarlabs.org/Tgillard/soas-v3-Mirabelle.mf soas-v3-Mirabelle.mf]
+# '''Download''': Download these three files:
-::[http://people.sugarlabs.org/Tgillard/soas-v3-Mirabelle.ovf soas-v3-Mirabelle.ovf]
+#:[http://people.sugarlabs.org/Tgillard/soas-v3-Mirabelle.mf soas-v3-Mirabelle.mf]
-::[http://people.sugarlabs.org/Tgillard/soas-v3-Mirabelle.vmdk soas-v3-Mirabelle.vmdk]
+#:[http://people.sugarlabs.org/Tgillard/soas-v3-Mirabelle.ovf soas-v3-Mirabelle.ovf]
-: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.
+#:[http://people.sugarlabs.org/Tgillard/soas-v3-Mirabelle.vmdk soas-v3-Mirabelle.vmdk]<br>
-:'''sugarroot''' is the root password.
+#:
-|-
+#:(Note that on some browsers on Mac OS X, the file extensions are reset upon download. You may have to modify them to match those shown above.)<br>
-| ||valign=top|'''(3) Launch''': VirtualBox
+#:'''sugarroot''' is the root password.
-|-
+# '''Launch''': VirtualBox
-| ||valign=top|'''(4) Import''': soas-v3-Mirabelle.ovf from the ''Import Appliance'' option under the ''File'' menu.
+# '''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.
+#: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.
+|colspan="2"|'''[[Downloads|Other virtual machines]]''' may also work but have not undergone testing with our images.
 |}
@@ Line 134: / Line 151: @@
 {|
 |-
-|style="width: 160px"| ||valign=top|Learn how to get setup on the [[Supported systems]] page.
+|width="174px" valign=top|[[File:Gear.png|link=Supported_systems]]
-|-
+|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:
+Some additional references you may find useful:
 * [[Development Team/Jhbuild | jhbuild]]
 * [http://git.sugarlabs.org Gitorious source code repository]
@@ Line 148: / Line 166: @@
 {|
 |-
-|style="width: 160px"|[[File:Sugar Creation Kit.png|left|link=Sugar Creation Kit]]||valign="top"|See [[Sugar Creation Kit]]
+|style="width: 180px"|[[File:Sugar Creation Kit.png|left|link=Sugar Creation Kit]]
+|valign="top"|See [[Sugar Creation Kit]]
 |}
@@ Line 157: / Line 176: @@
 {|
 |-
-|width="160px" valign="top"|Visit the [http://activities.sugarlabs.org Sugar Activity Library]||<imagemap>
+|width="170px" 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]]