Difference between revisions of "Sugar on a Stick"

From Sugar Labs
Jump to navigation Jump to search
 
(486 intermediate revisions by 42 users not shown)
Line 1: Line 1:
−
==About Sugar on a Stick==
+
<noinclude><!--{{ Translations | [[Sugar_on_a_Stick|english]] &#124; [[Sugar_on_a_Stick/lang-es|español]] &#124; [[Sugar_on_a_Stick/lang-fr|français]]}}-->
 +
[[Category:Project]]
 +
[[Category:Live USB]]
 +
[[Category:Sugar on a Stick]]
  
−
The goal of the Sugar on a Stick project is to give children access to *their* Sugar on any computer in their environment with just a USB key.
+
{{TeamHeader|Sugar on a Stick|home=Project Home|xbgColor=ffe792}}__NOTOC__</noinclude>
  
−
We are still in preAlpha on this project. It is not ready to use with children yet.
+
==What is Sugar on a Stick?==
 +
{{:Sugar on a Stick/Downloads}}
 +
=== What's new in Sugar on a Stick? ===
 +
* Sugar [[0.118]], see the [[0.118/Notes|release notes for 0.118]],
 +
* several updated activities,
 +
* based on Fedora 35, see the [[fedoradocs:fedora/f34/release-notes/|release notes for Fedora 35]]
 +
:
  
 +
==== Known bugs ====
  
−
===Creating a USB Stick===
+
* See also [[fedora:Common_F34_bugs|Common Fedora 35 bugs]].
  
−
The basics of creating a Live, bootable USB are you download a '.iso' image.  Then you use a USB creator program to copy it to a USB, create a space for users to store files on the USB (if required) and set it to be bootable.
+
== Sugar on a Stick installation instructions ==
 +
=== MS Windows ===
  
−
In practice this means the first thing you need is a Live USB creator.
+
{|
 +
|-
 +
|width="160px" valign="top"|[[File:Windows.gif|left|link=Sugar on a Stick/Windows]]
 +
<br><br><br>
 +
<span class="linkgroup">[[File:Download Mirabell.png|left|link=Sugar on a Stick/Downloads]]</span>
 +
[[File:USB flash drive.jpg|left|156px|link=Sugar on a Stick/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''' the latest [[Sugar on a Stick/Downloads | Sugar on a Stick]] .iso file.<br><br>
 +
# '''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.<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.
 +
|}
  
−
We are working with live USBs based on both Fedora and Ubuntu (these are different distributions of Linux), you can try either or both.
+
Detailed [[Sugar on a Stick/Windows|installation instructions for Windows]] and [[Sugar on a Stick/Boot|booting instructions]] are available. There is also a [[Getting Started/Explore|guide to exploring Sugar]].
 +
----
 +
=== GNU/Linux ===
 +
{|style="width: 800px;"
 +
|-
 +
|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:USB flash drive.jpg|156px|link=Sugar on a Stick/Downloads]]
 +
|valign=top|
 +
{{:Sugar on a Stick/Linux/Installation}}
 +
|}
  
−
====Fedora based Sugar on a Stick from Windows====
+
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 [[Getting Started/Explore|guide to exploring Sugar]].
 +
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.
 +
----
  
−
To create a Fedora based Sugar from a Windows machine: http://sdz.fedorapeople.org/olpc/liveusb-creator-3.0.zip
+
=== Apple Mac OS X ===
 +
{|
 +
|-
 +
|width="160px" valign="top"|[[File:Apple.gif|link=Macintosh]]
 +
<br>
 +
<span class="linkgroup">[[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|
 +
The instructions below are based on the Ubuntu Web page at &lt;http://www.ubuntu.com/download/desktop/create-a-usb-stick-on-mac-osx&gt;.
 +
# '''Prepare''': These instructions are for '''32-bit''' and '''64-bit''' processors.<br><br>
 +
# '''Download''' the latest [[Sugar on a Stick/Downloads|Sugar on a Stick]] .iso file.<br><br>
 +
# '''Load''': <br>Here is a simple way to load a bootable USB on a Mac.<br>
 +
## Enter the Terminal: <code>/Applications/Utilities/Terminal</code>.
 +
## Type <code>diskutil list</code>. You should see all the disk drives you have inserted into your computer.
 +
## Insert the disk drive to which you want to write Sugar on a Stick.
 +
## Type <code>diskutil list</code> again. You should see that your USB drive has been added to the list. If not, wait a while and repeat.
 +
## Type <code>hdiutil convert -format UDRW -o &lt;<i>Sugar on a Stick image file</i>&gt;.img &lt;<i>Sugar on a Stick image file</i>&gt;</code> to convert the image into a bootable format.
 +
## Type <code>sudo diskutil unmountDisk &lt;<i>device name</i>&gt;</code> to unmount the disk (it will not be ejected).
 +
## Type <code>sudo dd if=&lt;<i>Sugar on a Stick image file</i>&gt;.img.dmg of=&lt;<i>device name</i>&gt; bs=1m</code>. <code>sudo</code> will ask for your password, and then <code>dd</code> will start writing the disk file.
 +
## When <code>dd</code> finishes writing the disk file, type <code>sudo diskutil eject &lt;<i>device name</i>&gt;</code>.
 +
# '''Boot''': Insert the USB stick into a USB port on your computer, then reboot and press and hold the Option key while rebooting. You should see a list of all the EFI-recognizable USB drives that can be bootstrapped. If Sugar on a Stick is not one such drive, it cannot be bootstrapped: you need rEFInd (a fork of rEFIt).<br>
 +
<br>
 +
:* Have a MacBook? Consider these options:
 +
::[[File:Usb1.png|50px]] [[Testing/Reports/Sugar on a Stick#MacBook Persistent SoaS v5 USB EFI Boot|'''MacBook Persistent SoaS v5 USB EFI Boot''']]
 +
:: [[Talk:Downloads#Bootable_CD_of_Trisquel_4.5_for_MacBook_Air|Bootable CD of Trisquel 4.5 for MacBook Air]]
 +
:: See other installation variations at [[Sugar Creation Kit]]
 +
::[[File:Apple.gif|30px]] [[Tutorials/Installation/Burn_a_CD.iso_on_a_Mac|'''Burning a CD from an .iso file on a Mac''']]
 +
|}
  
−
Download that file to a windows machine and install it.
+
Alternative [[Macintosh|installation instructions for Mac OS X]]. Also, [[Sugar_on_a_Stick/Blueberry#For_Mac_OS_X_Users|these older installation instructions]] and [[Sugar on a Stick/Boot|booting instructions]] may be consulted.<br>There is also a [[Getting Started/Explore|guide to exploring Sugar]].
 +
----
  
−
Next download current version of Sugar that we are testing for Sugar on a Stick:
+
===Advanced users===
 +
==Do you have an OLPC XO?==
  
−
* http://download.sugarlabs.org/soas/soas-4.iso
+
{|
 +
|-
 +
|width="174px"|[[File:OLPCXO.png|middle|link=olpc:Releases]]
 +
|valign=top|
 +
* '''Upgrade''' to the latest ''[[olpc:Releases]]'' from OLPC (which may require a [[olpc:Activation_and_developer_keys|developer key]]).
  
−
#Plug in a 1GB or larger USB stick into your computer.
+
* '''Experiment''' with [[Sugar_on_a_Stick/Installation/OLPC|Updating XOs]] to the latest ''Sugar on a Stick'' release.
−
#Open "liveusb-creator.exe"
+
|}
−
#Use "Browse" to find "liveusb.iso" that you just downloaded.
 
−
#Set the Target Device to your USB device
 
−
#Click "Create Live USB". It will take a few minutes.
 
  
−
How much persistent memory you set will depend on the size of the .iso and the size of your USB but make sure you have some so people can save files.
+
<br/><br/>
 +
==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 34 SoaS Live CD/USB may be used to install Fedora with Sugar to a hard disk or a 4 GB USB stick [[Tutorials/Installation/Install with liveinst|with the '''{{Code|liveinst}} command''']].
 +
:- You start with a SoaS LiveOS image, and then load an uncompressed version onto the hard disk or USB stick.
  
−
====Ubuntu based Sugar on a Stick====
+
=== Want to contribute to Sugar on a Stick? ===
 +
{|
 +
|-
 +
| style="border: 0; border-width: 0; width: 350px;" | [[File:SoaS-contributors.jpg |300px|left|link=Sugar_on_a_Stick]]
 +
| style="border: 0; border-width: 0;" |
 +
You're in the right place! This page is a contributors portal to the project, and contains everything you need to get started in becoming part of the Sugar on a Stick community.
 +
|}
  
−
Ubuntu contains an application called 'USB-creator' (use apt-get or other package management application to download it from the repositories) which can copy an Ubuntu based LiveCD to an USB drive automatically and make it bootable. USB-creator can use the currently running LiveCD or a specficied '.iso' image, and provides for a option for persistant storage using a read-write file on the same partition as files from the CD (some systems use a seperate partition).
+
== New contributors start here! ==
  
−
There another application UCK (Ubuntu Customization Kit) which can be used to remaster a LiveCD image to remove/include applications, change the artwork etc....
+
Welcome! We're excited that you want to help us bring the Sugar Learning Platform to children around the world. No prior experience with computers or educational technology is required - in fact, we actively encourage a diversity of backgrounds, ages, and perspectives. See the [[Joining Sugar on a Stick]] page for instructions on how to get started.
  
−
There is a Ubuntu Wiki article which walks though the stages of modifying a LiveCD image http://help.ubuntu.com/community/LiveCDCustomization
+
== What can you do? ==
  
−
===Using Sugar on a Stick===
+
There are three main ways you can contribute to the Sugar on a Stick community. We work closely with our upstreams, [http://sugarlabs.org Sugar Labs] and [http://fedoraproject.org the Fedora Project].
  
−
The trick is to set the BIOS to boot from USB.  Unfortunately this is slightly different on each computer.  Try Google on BIOS your computer model and explore the setup screen for your system.
+
=== Get Activities on the Stick ===
  
−
If you have trouble try creating a "Boot Helper" CD using the .iso below.  This will start the boot from the CD then read files from the USB.
+
{|
 +
|-
 +
| style="border: 0; border-width: 0;" |
  
−
* http://www.sugarlabs.org/~marco/boot.iso
+
We're always looking for help with all aspects of the [[Sugar on a Stick release process]]. Here are a few things you can do:
  
−
You can also use the 'PLoP Boot Manager' to create a boot floppy for machines without the ability to boot from CD or USB, see http://syslinux.zytor.com/wiki/index.php/No_native_BIOS_support
+
* [[Sugar on a Stick QA|Test Sugar on a Stick]] and help us find bugs and think of ways the project could be better. When you find a bug or think of an enhancement, [[How to file a ticket|file a ticket!]] ''No technical experience required.''
 +
* Help make it easier for others to test Sugar on a Stick by writing [[Sugar on a Stick QA#Test cases|test cases]]. ''If you've run a test case, you can write a test case.''
 +
* [http://bugs.sugarlabs.org Fix a bug or add a feature] to an existing Activity, to [[Development Team|sugar-core itself]], or to [http://bugs.sugarlabs.org/query?status=accepted&status=assigned&status=new&status=reopened&component=SoaS&order=priority&col=id&col=summary&col=status&col=type&col=priority&col=milestone&col=component Sugar on a Stick]. See [[How to fix an Activity bug]] and [[How to fix a sugar-core bug]] to get started. ''Basic Python programming skills - or the desire to learn - are all that's needed.''
 +
* [https://fedoraproject.org/wiki/Sugar_Activities Package Sugar Activities for Fedora]. ''If you're a [https://fedoraproject.org/wiki/PackageMaintainers/Join Fedora Packager] or want to become one, help in this area is something we desperately need - it's a trickier thing to learn, but rewarding once you get the hang of it.''
 +
* [[Sugar on a Stick release process#Review|Review Activities for inclusion in the build]] - check submitted Activities against our [[Sugar on a Stick/Activity Criteria]] and help us choose what gets included in the next release! ''No prior experience needed.''
 +
* Have an idea for a technical feature that isn't an Activity? Check out our [[Sugar on a Stick release process#Feature process|feature process]].
  
 +
| style="border: 0; border-width: 0; width: 150px;" |[[Image:SoaS-netbook-1.jpg|150px|right|link=http://wiki.sugarlabs.org/go/Sugar_on_a_Stick_release_process]][[Image:SoaS-netbook-2.jpg|150px|right|link=http://wiki.sugarlabs.org/go/Sugar_on_a_Stick_release_process]][[Image:SoaS-netbook-3.jpg|150px|right|link=http://wiki.sugarlabs.org/go/Sugar_on_a_Stick_release_process]]
 +
|}
  
−
===Join the development effort===
+
=== Get Sticks into Schools ===
  
−
We are coordinating work on this project on Sugar Labs Moodle system. Please create an account and join the Sugar on a Stick Class. http://schools.sugarlabs.org/course/view.php?id=17
+
{|
 +
|-
 +
| style="border: 0; border-width: 0; width: 250px;" | [[File:Cici-stick.jpg |200px|left|link=Sugar_on_a_Stick_deployment_process]]
 +
| style="border: 0; border-width: 0;" |
 +
Deployments all over the world need many different types of help as they work through the [[Sugar on a Stick deployment process]] - we need help building resources for all deployments to use, supporting those deployments, and helping new deployments start, as well as gathering stories and feedback from deployments so that we can make the next version of Sugar on a Stick even better.
  
−
====Report Sugar on a Stick Bugs====
+
Some things you can do to help:
  
−
*Use the Sugar Trac system at http://dev.sugarlabs.org to report bugs. Use the "Sugar on a Stick" component.
+
* ''"It's a wiki: Edit away!"'' is often said in open source communities. Almost nothing is set in stone and can't be undone. So if you've got ideas how to make instructions clearer and more accessible, just go for it!
 +
* We produce official documentation such as the [http://download.sugarlabs.org/soas/docs/creation-kit/ Creation Kit] or the [http://download.sugarlabs.org/soas/docs/customization-guide/ Customization Guide]. If you've an idea how to make them better, why don't you jump in and create a patch? Creating these nifty text files is simple - instructions live in the [[Sugar_on_a_Stick/Documentation_SOP|Documentation SOP]].
 +
* Unofficial documentation for unsupported workarounds for [[Sugar on a Stick/Installation|installation]] and [[Sugar on a Stick/Sugar Clone|customization]] need to be edited, tested, and submitted for approval for official support. Check them out and leave comments and improvements; just jump in and edit the page.
 +
* Interested in starting a deployment or helping a specific one (with anything from pedagogical design to technical support to funding logistics)? Introduce yourself on the deployment lists for [http://lists.sugarlabs.org/ Sugar Labs] and [http://lists.laptop.org/listinfo/ One Laptop Per Child] and we'll get you connected with some teachers on the ground.
 +
* We're looking for some people to help us assemble tools for our support team to use. Email the [http://lists.sugarlabs.org/listinfo/soas Sugar on a Stick mailing list] if you're interested.
 +
|}
  
−
===Details about the project===
+
=== Get Contributors ===
  
−
*[[DeploymentTeam/School_Key]]
+
{|
 +
|-
 +
| style="border: 0; border-width: 0;" |
 +
 
 +
Contributors are the lifeblood of the Sugar on a Stick community - we work hard to bring a playful mindset of teaching, learning, and meaningful work to the children we aim to reach, and we aim to keep that mindset in our own work and community as well. Welcoming and teaching new contributors or all types, building the resources they need, and teaching them how to empower others in their turn is one of the most important things you can do; it is ''everyone's'' responsibility to help build our community, one person at a time.
 +
 
 +
Some things you can do:
 +
 
 +
* Edit this page and [[Joining Sugar on a Stick]]. Is there something we could do to make the "getting started" process easier? You don't have to ask permission to edit; just do it!
 +
* Help us fill in our remaining task-starter pages: [[Sugar on a Stick release process]], [[How to fix an Activity bug]], [[How to fix a sugar-core bug]], and [[Sugar on a Stick deployment process]]/
 +
* [http://openhatch.org/+projects/Sugar%20on%20a%20Stick Point out starter tasks on OpenHatch] - fill in questions and ideas for beginner jobs, and point newcomers towards them.
 +
* [http://lists.sugarlabs.org/listinfo/soas Watch for introductions on the mailing list], and send welcome emails to new contributors (copy the list, so we can see what advice a newcomer has gotten so far).
 +
* Hang out with us on IRC: [http://webchat.freenode.net?channels=sugar #sugar]. This is where the [http://activities.sugarlabs.org/en-US/sugar/addon/4029 IRC Activity] starts off. Help new joiners past initial questions and provide instant help!
 +
 
 +
| style="border: 0; border-width: 0; width: 200px;" |[[Image:Cici-netbook.jpg|200px|right|link=http://wiki.sugarlabs.org/go/Sugar_on_a_Stick]]
 +
|}
 +
 
 +
== What's happening? ==
 +
===[[Sugar on a Stick/Beta]]===
 +
 
 +
=== Contributor stories ===
 +
 
 +
To find out what other contributors are doing, check out [http://planet.sugarlabs.org Planet Sugar Labs], where contributors to Sugar Labs and the Sugar on a Stick project aggregate their blogs. You can also [[Sysadmin/Planet syndication request|add your own blog to the Planet]].
 +
 
 +
=== <s>Meetings</s> ===
 +
 
 +
Communication through the [http://lists.sugarlabs.org/listinfo/soas Sugar on a Stick mailing list] has replaced regular meetings.
 +
:We once had weekly meetings on IRC - see [[Sugar on a Stick meetings]] for more information, including logs from past meetings.
 +
 
 +
== Related work ==
 +
 
 +
While the projects listed below are not part of Sugar on a Stick, we watch them closely and try to work with them when possible (or at least we're trying to learn!)
 +
 
 +
* For deployments lacking easy Internet access, one can turn a computer into a '''Sugar on a Stick Creation Station'''. The [[Sugar Creation Kit]] includes the materials you need to create Live USB sticks sticks and to install additional Activities, along with documentation and previous versions of Sugar on a Stick.
 +
* Older [[:Category:Live USB|portable Sugar distributions]] based on other Linux distributions .
 +
* [[The undiscoverable]] is an unofficial FAQ for tips, tricks, and solutions to common problems that may otherwise be tricky to find. These are being considered for inclusion in the official SoaS documentation.
 +
 
 +
== Previous versions and other subpages index ==
 +
{{Show|Earlier versions of Sugar on a Stick and other project pages can be reviewed at these pages: |{{Special:PrefixIndex/Sugar on a Stick/}}}}

Latest revision as of 12:08, 16 February 2022


Project Home   ·   Join   ·   Contacts   ·   Resources   ·   FAQ   ·   Roadmap   ·   To Do   ·   Meetings

What is Sugar on a Stick?

SugaronastickAvocado-320px.png
 Sugar on a Stick is a Fedora® Spin operating system featuring the award-winning Sugar Learning Platform.

Sugar on a Stick will run on

  • any 64-bit Notebook, Laptop, or Desktop computer, with a minimum of 1GB RAM, that can run Linux, Windows or macOS, using a USB thumbdrive or stick, as a Live USB,
  • a 32-bit computer with the TOAST version of Sugar (Trisquel on a Sugar Toast). See Trisquel On A Sugar Toast.
  • a Raspberry Pi 2 or 3, using a microSD card, or;
  • any computer as a virtual machine.

You can use Sugar on a Stick to demo Sugar almost anywhere without disturbing the contents of the computer you use, and if people like what they see, you can install Sugar on a Stick to their hard drives or other sticks from the demo stick.

Download Mirabell.png

x86_64 (64-bit)

Download Mirabell.png armhfp Raspberry Pi 2 or 3, see How to install.


Fedora and the Infinity design logo are trademarks of Red Hat, Inc.

What's new in Sugar on a Stick?

Known bugs

Sugar on a Stick installation instructions

MS Windows

Windows.gif




Download Mirabell.png
USB flash drive.jpg
  1. Prepare: Download the Fedora Live USB Creator from FedoraHosted.

  2. Download the latest Sugar on a Stick .iso file.

  3. 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.

  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 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


Gnulinux.png


Download Mirabell.png

USB flash drive.jpg

  1. Download the latest Sugar on a Stick .iso file.

  2. Prepare: (with root user permissions at a terminal or console command line)
    • Create a mount point directory: mkdir /run/soas
    • Mount the .iso file to make it accessible as a disk: mount /path/to/downloaded.iso /run/soas/
      (Where /path/to/downloaded.iso is the filesystem path, or fully specified name, of the downloaded .iso file.)
      This is the source for the installation, and must remain mounted until the installation is complete.
    • Insert a USB stick of 2 GB or greater capacity into your computer.
    • With root user permissions at a terminal or console command line, use the command sudo df -Th or sudo blkid to get the USB device node name.
      • (Items in angle brackets, such as <MyAccount> are descriptive placeholders.)
       You should see something like the following: 
      [<user>@<system> <working directory>]$ sudo df -Th
Filesystem     Type      Size  Used Avail Use% Mounted on
devtmpfs       devtmpfs   16G     0   16G   0% /dev
tmpfs          tmpfs      16G   33M   16G   1% /dev/shm
tmpfs          tmpfs      16G  1.8M   16G   1% /run
tmpfs          tmpfs      16G     0   16G   0% /sys/fs/cgroup
/dev/sda1      ext4      123G   17G  100G  15% /
tmpfs          tmpfs      16G   80K   16G   1% /tmp
tmpfs          tmpfs     3.2G   10M  3.2G   1% /run/user/1000
/dev/sdb1      vfat      233G   90G  143G  39% /run/media/<MyAccount>/<filesystem label>
/dev/loop0     iso9660   942M  942M     0 100% /run/soas
      (The /run/media/<MyAccount>/ path is the standard mount point for removable media.
      /media/<MyMountPoint> is common on other operating systems.)
      [<user>@<system> <working directory>]$ sudo blkid
/dev/sda1: LABEL="Fedora30" UUID="dddf4ae0-e1fd-43c3-bacc-91acbafb3a34" TYPE="ext4" PARTUUID="000b2340-03"
/dev/sdb1: LABEL_FATBOOT="Fat" LABEL="Fat" UUID="D082-05E1" TYPE="vfat" PARTLABEL="Fat" PARTUUID="53132329-808c-4a44-adf6-e98ad17546ff"
/dev/loop0: UUID="2019-04-26-02-18-05-00" LABEL="Fedora-SoaS-Live-30-1-2" TYPE="iso9660" PTUUID="37f2045d" PTTYPE="dos"
      (Additional disk drive partitions may be listed on your computer.)
      The mount point (Mounted on), Filesystem, Size, and LABEL should help you identify what you want.
    • Unmount the USB device filesystem:
      umount /run/media/<MyAccount>/<MyUSBdiscMountPoint>
      (The /run/media/<MyAccount>/ path is the standard mount point. Other operating systems may use /media/<MyMountPoint>.)
    • (You should have the isomd5sum package installed so that the following installation script can verify the download.)

  3. Load: Execute the following installation command, as the root user, in one command line with many options:
    /run/soas/LiveOS/livecd-iso-to-disk --reset-mbr --overlay-size-mb 500 --home-size-mb 500 --unencrypted-home /path/to/downloaded.iso /dev/sd?1
    The '?' in the final parameter represents the target USB device scsi drive node, such as sdb1 or sdc1, etc., and /path/to/downloaded.iso is the location and name of the .iso file.
    The operating system will occupy ~960 MB, and the overlay and home size arguments, 500 and 500, were selected to fit in a 2 GB device. These may be adjusted depending on your preferences and device capacity (see LiveOS image). On a 4 GB device, one might use 1000 and 1600 for the size arguments.
     The installation transcript should look something like the following: 
    [<user>@<system> <working directory>]$ sudo /run/soas/LiveOS/livecd-iso-to-disk --reset-mbr --overlay-size-mb 500 --home-size-mb 500 --unencrypted-home /<path to>/Fedora-SoaS-Live-x86_64-30-1.2.iso /dev/sdc1
Verifying image...
/<path to>/Fedora-SoaS-Live-x86_64-30-1.2.iso:   bac65eaf45ad370f6e9ddf793f436e33
Fragment sums: 82358a8de12fab19be3e83c22431837827fbe4b8be6d9be46695f853676f
Fragment count: 20
Supported ISO: no
Press [Esc] to abort check.
Checking: 100.0%

The media check is complete, the result is: PASS.

It is OK to use this media.

Copying LiveOS image to target device...
squashfs.img
    887,312,384 100%  379.28MB/s    0:00:02 (xfr#1, to-chk=0/1)

Syncing filesystem writes to disc.
    Please wait, this may take a while...
Setting up /EFI/BOOT
Updating boot config files.
Initializing persistent overlay...
500+0 records in
500+0 records out
524288000 bytes (524 MB, 500 MiB) copied, 0.354372 s, 1.5 GB/s
Initializing persistent /home
500+0 records in
500+0 records out
524288000 bytes (524 MB, 500 MiB) copied, 0.346354 s, 1.5 GB/s
Formatting unencrypted home.img
mke2fs 1.44.6 (5-Mar-2019)
Creating filesystem with 512000 1k blocks and 128016 inodes
Filesystem UUID: b32a4987-627e-4131-a863-7f6c9bcc2178
Superblock backups stored on blocks: 
	8193, 24577, 40961, 57345, 73729, 204801, 221185, 401409

Allocating group tables: done                            
Writing inode tables: done                            
Creating journal (8192 blocks): done
Writing superblocks and filesystem accounting information: done 

tune2fs 1.44.6 (5-Mar-2019)
Setting maximal mount count to -1
Setting interval between checks to 0 seconds
Installing boot loader...
Target device is now set up with a Live image!

  4. 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.

  • To create more Sugar Sticks on other 2 GB or greater USB or SD devices, while running Sugar on a Stick, one may run the Terminal Activity, and execute this command as the root user:
    livecd-iso-to-disk --reset-mbr --overlay-size-mb 500 --home-size-mb 500 --delete-home --unencrypted-home /run/initramfs/livedev /dev/sd?1
Replace /dev/sd?1 with a new device node for the second USB/SD device that you want to load with Sugar on a Stick.

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

Apple.gif


Download Mirabell.png

USB flash drive.jpg

The instructions below are based on the Ubuntu Web page at <http://www.ubuntu.com/download/desktop/create-a-usb-stick-on-mac-osx>.

  1. Prepare: These instructions are for 32-bit and 64-bit processors.

  2. Download the latest Sugar on a Stick .iso file.

  3. Load:
    Here is a simple way to load a bootable USB on a Mac.
    1. Enter the Terminal: /Applications/Utilities/Terminal.
    2. Type diskutil list. You should see all the disk drives you have inserted into your computer.
    3. Insert the disk drive to which you want to write Sugar on a Stick.
    4. Type diskutil list again. You should see that your USB drive has been added to the list. If not, wait a while and repeat.
    5. Type hdiutil convert -format UDRW -o <Sugar on a Stick image file>.img <Sugar on a Stick image file> to convert the image into a bootable format.
    6. Type sudo diskutil unmountDisk <device name> to unmount the disk (it will not be ejected).
    7. Type sudo dd if=<Sugar on a Stick image file>.img.dmg of=<device name> bs=1m. sudo will ask for your password, and then dd will start writing the disk file.
    8. When dd finishes writing the disk file, type sudo diskutil eject <device name>.
  4. Boot: Insert the USB stick into a USB port on your computer, then reboot and press and hold the Option key while rebooting. You should see a list of all the EFI-recognizable USB drives that can be bootstrapped. If Sugar on a Stick is not one such drive, it cannot be bootstrapped: you need rEFInd (a fork of rEFIt).


  • Have a MacBook? Consider these options:
Usb1.png MacBook Persistent SoaS v5 USB EFI Boot
Bootable CD of Trisquel 4.5 for MacBook Air
See other installation variations at Sugar Creation Kit
Apple.gif Burning a CD from an .iso file on a Mac

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?

OLPCXO.png
  • 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 34 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.

Want to contribute to Sugar on a Stick?

SoaS-contributors.jpg

You're in the right place! This page is a contributors portal to the project, and contains everything you need to get started in becoming part of the Sugar on a Stick community.

New contributors start here!

Welcome! We're excited that you want to help us bring the Sugar Learning Platform to children around the world. No prior experience with computers or educational technology is required - in fact, we actively encourage a diversity of backgrounds, ages, and perspectives. See the Joining Sugar on a Stick page for instructions on how to get started.

What can you do?

There are three main ways you can contribute to the Sugar on a Stick community. We work closely with our upstreams, Sugar Labs and the Fedora Project.

Get Activities on the Stick

We're always looking for help with all aspects of the Sugar on a Stick release process. Here are a few things you can do:

SoaS-netbook-1.jpg
SoaS-netbook-2.jpg
SoaS-netbook-3.jpg

Get Sticks into Schools

Cici-stick.jpg

Deployments all over the world need many different types of help as they work through the Sugar on a Stick deployment process - we need help building resources for all deployments to use, supporting those deployments, and helping new deployments start, as well as gathering stories and feedback from deployments so that we can make the next version of Sugar on a Stick even better.

Some things you can do to help:

  • "It's a wiki: Edit away!" is often said in open source communities. Almost nothing is set in stone and can't be undone. So if you've got ideas how to make instructions clearer and more accessible, just go for it!
  • We produce official documentation such as the Creation Kit or the Customization Guide. If you've an idea how to make them better, why don't you jump in and create a patch? Creating these nifty text files is simple - instructions live in the Documentation SOP.
  • Unofficial documentation for unsupported workarounds for installation and customization need to be edited, tested, and submitted for approval for official support. Check them out and leave comments and improvements; just jump in and edit the page.
  • Interested in starting a deployment or helping a specific one (with anything from pedagogical design to technical support to funding logistics)? Introduce yourself on the deployment lists for Sugar Labs and One Laptop Per Child and we'll get you connected with some teachers on the ground.
  • We're looking for some people to help us assemble tools for our support team to use. Email the Sugar on a Stick mailing list if you're interested.

Get Contributors

Contributors are the lifeblood of the Sugar on a Stick community - we work hard to bring a playful mindset of teaching, learning, and meaningful work to the children we aim to reach, and we aim to keep that mindset in our own work and community as well. Welcoming and teaching new contributors or all types, building the resources they need, and teaching them how to empower others in their turn is one of the most important things you can do; it is everyone's responsibility to help build our community, one person at a time.

Some things you can do:

Cici-netbook.jpg

What's happening?

Sugar on a Stick/Beta

Contributor stories

To find out what other contributors are doing, check out Planet Sugar Labs, where contributors to Sugar Labs and the Sugar on a Stick project aggregate their blogs. You can also add your own blog to the Planet.

Meetings

Communication through the Sugar on a Stick mailing list has replaced regular meetings.

We once had weekly meetings on IRC - see Sugar on a Stick meetings for more information, including logs from past meetings.

Related work

While the projects listed below are not part of Sugar on a Stick, we watch them closely and try to work with them when possible (or at least we're trying to learn!)

  • For deployments lacking easy Internet access, one can turn a computer into a Sugar on a Stick Creation Station. The Sugar Creation Kit includes the materials you need to create Live USB sticks sticks and to install additional Activities, along with documentation and previous versions of Sugar on a Stick.
  • Older portable Sugar distributions based on other Linux distributions .
  • The undiscoverable is an unofficial FAQ for tips, tricks, and solutions to common problems that may otherwise be tricky to find. These are being considered for inclusion in the official SoaS documentation.

Previous versions and other subpages index

Earlier versions of Sugar on a Stick and other project pages can be reviewed at these pages:
Retrieved from "https://wiki.sugarlabs.org/index.php?title=Sugar_on_a_Stick&oldid=104042"