Difference between revisions of "Downloads"

Revision as of 17:53, 13 July 2012

HowTo [ID# 81057]

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 quickest download is Sugar on a Stick. Basic instructions are found below:

Sugar on a Stick installation instructions

MS Windows

Prepare: Download the Fedora Live USB Creator from FedoraHosted.
Download the latest Sugar on a Stick .iso file.
Load: Insert a USB flash drive (or SD Card) with 2 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 exploring Sugar.

GNU/Linux

Download the latest Sugar on a Stick .iso file.
Prepare:
- Create a mount point: sudo mkdir /media/soas
- Mount the .iso file as a disk: mount /path/to/source.iso /media/soas/
- Insert a USB stick of 2 GB or greater capacity into your computer.
- Use the sudo blkid or df command to get the USB device node name.
- (You should have the isomd5sum package installed so that the following installation script can verify the download.)
Load: Execute, as the root user in one command with arguments, the following:
sudo /media/soas/LiveOS/livecd-iso-to-disk --reset-mbr --overlay-size-mb 500 --home-size-mb 900 --delete-home --unencrypted-home /path/to/source.iso /dev/sd?1

where '?' in the final parameter represents the target USB device node, such as sdb1 or sdc1, etc. and /path/to/source.iso file is the location and name of the .iso file.
Boot: Insert the USB stick into a bootable USB port on your computer. Set the option to "boot from USB" in your computer's BIOS setup, and then start up the computer.

You may create more Sugar Sticks on other 1 GB or greater USB or SD devices. In the Terminal Activity of a running Sugar on a Stick, run this command as root:
/LiveOS/livecd-iso-to-disk --reset-mbr --overlay-size-mb 300 --home-size-mb 175 --delete-home --unencrypted-home /run/initramfs/livedev /dev/sd?1

Detailed installation instructions for GNU/Linux and booting instructions are available. There is also a guide to exploring Sugar. GNU/Linux users may also want to install the Sugar packages on their favorite distro, apart from Sugar on a Stick.

Apple Mac OS X

DRAFT: These instructions are incomplete. Please help with testing and documentation. In the meantime, we recommend 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 the latest Sugar on a Stick .iso file. Be sure to download a 64-bit image.
Load: Help: Does someone have a simple way to load a Live USB on a Mac?
Here is a simple way to recognize a bootable USB on a Mac.
Go to rEFIt (http://refit.sourceforge.net/) and make a bootable cd. There is no need to install rEFIt on your mac. In fact installing rEFIt may make it impossible to upgrade the Mac OS to a newer version later on (personal experience, I had to do a clean install). Put the rEFIt CD in and hold the option key after turning the computer on. The Mac will recognize the CD because it uses EFI and then the CD will recognize the bootable USB.
- How to Burn a rEFIt CD
You can rename the .cdr file to .iso for use in GNU/Linux.
- Building and Booting a Live USB stick 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.

Have a MacBook? Consider these options:

MacBook Persistent SoaS v5 USB EFI Boot

Bootable CD of Trisquel 4.5 for MacBook Air

See other installation variations at Sugar Creation Kit

Burning a CD from an .iso file on a Mac

Have an iBook or PowerPC Mac?

See Ubuntu/PPC and Fedora#PowerPC.

Alternative installation instructions for Mac OS X. Also, these older installation instructions and booting instructions may be consulted.
There is also a guide to exploring Sugar.

Advanced users

Do you have an OLPC XO?

Upgrade to the latest olpc:Releases from OLPC.

Upgrade to Dextrose (requires a developer key).

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

Some alternate installations

Once you download, and then burn or load a Sugar on a Stick (SoaS) .iso file, and boot it, the running Fedora 17 SoaS Live CD/USB may be used to install Fedora with Sugar to a hard disk or a 4 GB USB stick with the liveinst command.

- You start with a SoaS LiveOS image, and then load an uncompressed version onto the hard disk or USB stick.

- The Fedora-17-Live-SoaS.iso file is a 509 MB download.

If you have a high-speed Internet connection,
Fedora with the Sugar graphical learning environment may be installed to a hard disk or a a 4 GB USB stick with a Netinstall CD.

- Not a compressed LiveOS image like SoaS, but all of Sugar.

- This requires a high-speed Internet connection for software component downloading during installation.

Do you use GNU/Linux?

Sugar is supported by several GNU/Linux distributions. Sugar Labs does not support any specific distribution, but does focus development on Fedora and Debian, which helps SoaS and Ubuntu.

Logo	Name	Notes
	Sugar on a Stick	Live system of the Sugar Learning Environment
	Fedora	Fedora 34
	Ubuntu	Ubuntu 18.04 Bionic
	Debian	Debian Stretch, see also Live Build
	OLPC OS 16.04	OLPC OS for OLPC NL3 laptops based on Ubuntu 16.04 Xenial
	OLPC OS 13.x	OLPC OS for OLPC XO laptops based on Fedora 18
	openSUSE	Part of an Linux for Education (Li-f-e) series
	Trisquel Toast	Based on Ubuntu

Please note:

Development changes occur rapidly, and the text here lags the current state of systems development.
For the latest information on any development project, visit their work sites.

Are you a developer?

Learn how to get setup on the Supported systems page.

Some additional references you may find useful:

Sweets, to launch Sugar using the Sugar Package Management System
JHBuild
Gitorious source code repository
Virtual machine or emulator image files
Adding Sugar to your favorite distro...

Virtual Machines on all platforms

VirtualBox Appliances

More Virtual Appliances

Sugar included in other GNU/Linux operating systems, and older versions.

Also includes some VMware Player Appliances

If you run into problems, you may want to consult the Talk:VirtualBox page for help.

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 27: / Line 27: @@
 ----
 === GNU/Linux ===
-{|
+{|style="width: 800px;"
 |-
-|width="160px"|<span class="linkgroup">[[File:Gnulinux.png|link=Sugar on a Stick/Linux]]
+|width="160px" valign=top|<br><span class="linkgroup">[[File:Gnulinux.png|link=Sugar on a Stick/Linux]]
 <br>
-[[File:Download Mirabell.png|left|link=Sugar on a Stick/Downloads]] </span>
+[[File:Download Mirabell.png|left|link=Sugar on a Stick/Downloads]]</span>
 [[File:USB flash drive.jpg|156px|link=Sugar on a Stick/Downloads]]
 |valign=top|
-# '''Prepare''': Use this script [http://git.fedorahosted.org/git?p=hosted/livecd;a=blob_plain;f=tools/livecd-iso-to-disk.sh;hb=HEAD livecd-iso-to-disk] to create a bootable image.<br>(You may need to run {{Code|chmod +x tools_livecd-iso-to-disk.sh}} after you download the script to make it executable.) <br>You should have the isomd5sum package installed so that the script can verify the download.<br><br>
 # '''Download''' the latest [[Sugar on a Stick/Downloads | Sugar on a Stick]] .iso file.<br><br>
-# '''Load''': Insert a USB stick of 2 GB or greater capacity. Execute, as the '''root''' user, in the directory where you downloaded the script, in <u>one</u> command with arguments, the following:
+# '''Prepare''':
-#:{{Code|./tools_livecd-iso-to-disk.sh --reset-mbr --overlay-size-mb 500 --home-size-mb 900 --delete-home --unencrypted-home '''/path/to/source'''.iso /dev/sd'''?'''1}}
+#* Create a mount point: {{Code|sudo mkdir /media/soas}}
-#: where '{{Code|'''?'''}}' in the final parameter represents the target bootable device node, such as {{Code|sdb1}} or {{Code|sdc1}}, etc. and /path/to/source is the location and name of the .iso file. You can use the {{Code|blkid}} or {{Code|df}} command to get the device node name.<br><br>
+#* Mount the .iso file as a disk: {{Code|mount '''/path/to/source'''.iso /media/soas/}}
-# '''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.
+#* Insert a USB stick of 2 GB or greater capacity into your computer.
-#* You may create more Sugar Sticks on extra USB or SD devices from within a running ''Sugar on a Stick'' by running this command in the Terminal activity as root (doesn't work with alternative installation methods):
+#* Use the {{Code|sudo blkid}} or {{Code|df}} command to get the USB device node name.
-#*:{{Code|/LiveOS/livecd-iso-to-disk --reset-mbr --overlay-size-mb 300 --home-size-mb 175 --delete-home --unencrypted-home /dev/sr0 /dev/sd?1}}
+#* (You should have the isomd5sum package installed so that the following installation script can verify the download.)<br><br>
+# '''Load''': Execute, as the '''root''' user in <u>one</u> command with arguments, the following:<br><div style="padding: 1em; border: 1px dashed #2F6FAB; background-color: #FBFBFB; margin: 1em 0px 1em 1.6em; font-family: Courier;">sudo /media/soas/LiveOS/livecd-iso-to-disk --reset-mbr --overlay-size-mb '''500''' --home-size-mb '''900''' --delete-home --unencrypted-home '''/path/to/source'''.iso /dev/sd'''?'''1</div>
+#: where '{{Code|'''?'''}}' in the final parameter represents the target USB device node, such as {{Code|sd'''b'''1}} or {{Code|sd'''c'''1}}, etc. and '''/path/to/source'''.iso file is the location and name of the .iso file.<br><br>
+# '''Boot''': Insert the USB stick into a bootable 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.<br><br>
+::* You may create more Sugar Sticks on other 1 GB or greater USB or SD devices. In the Terminal Activity of a running ''Sugar on a Stick'', run this command as root:<br><div style="padding: 1em; border: 1px dashed #2F6FAB; background-color: #FBFBFB; margin: 1em 0px 1em 0em; font-family: Courier;">/LiveOS/livecd-iso-to-disk --reset-mbr --overlay-size-mb '''300''' --home-size-mb '''175''' --delete-home --unencrypted-home /run/initramfs/livedev /dev/sd'''?'''1</div>
 |}
@@ Line 47: / Line 51: @@
 GNU/Linux users may also want to install the [[#Do_you_use_GNU.2FLinux.3F|Sugar packages]] on their favorite distro, apart from Sugar on a Stick.
 ----
 === Apple Mac OS X ===
 '''DRAFT''': These instructions are incomplete. Please help with testing and documentation. In the meantime, we recommend the '''[[#Virtual Machines on all platforms|Virtual Machines instructions]]''' below.