Changes

</noinclude>

</noinclude>

== Introduction ==

== Introduction ==

This page provides additional detail for installing '''[[Sugar on a Stick/Mirabelle|Mirabelle]]''', the most stable, released version of Sugar on a Stick (SoaS), available at [http://spins.fedoraproject.org/soas/#downloads this download site], onto a USB/SD flash storage device using GNU/Linux.

This page provides additional detail for installing '''[[Sugar on a Stick/Mango Lassi|Mango Lassi]]''', the most stable, released version of Sugar on a Stick (SoaS), available at [http://spins.fedoraproject.org/soas/#downloads this download site], onto a USB/SD flash storage device using GNU/Linux.

: To explore a variety of '''experimental''' options for putting a [[What is Sugar?|Sugar]] image on a USB or SD flash drive under GNU/Linux, see the following pages:

: To explore a variety of '''experimental''' options for putting a [[What is Sugar?|Sugar]] image on a USB or SD flash drive under GNU/Linux, see the following pages:

This is known to work in Fedora and Ubuntu.

This is known to work in Fedora and Ubuntu.

First, download a SoaS-Mirabelle {{Code|.iso}} image from  http://spins.fedoraproject.org/soas/#downloads, then return here.

First, download a SoaS {{Code|.iso}} image from  http://spins.fedoraproject.org/soas/#downloads, then return here.

::<small>(A program called UNetbootin available at http://unetbootin.sourceforge.net/ does all this magic for you... or you can do the magic yourself:)</small>

::<small>(A program called UNetbootin available at http://unetbootin.sourceforge.net/ does all this magic for you... or you can do the magic yourself:)</small>

* Run it as root, making sure to pass the correct USB device and to set overlay and home size appropriately, depending on the stick size.

* Run it as root, making sure to pass the correct USB device and to set overlay and home size appropriately, depending on the stick size.

: {{Code|sudo ./livecd-iso-to-disk.sh --reset-mbr --overlay-size-mb 300 --home-size-mb 175 --delete-home --unencrypted-home /path/to/SoaS.iso /dev/sd''b1''}}

: {{Code|sudo ./livecd-iso-to-disk.sh --reset-mbr --overlay-size-mb 300 --home-size-mb 175 --delete-home --unencrypted-home /path/to/SoaS.iso /dev/sd''b1''}}

:: '''Note:''' With the soas-2-blueberry.iso, leave out the 3 options for a separate persistent home.  The script will complete successfully, but the new installation startup process will have trouble finding the home folder and fail to complete.

:: The ''livecd-iso-to-disk'' installation method has advantages over the ''liveusb-creator'' method by allowing the creation of a separate,  persistent /home/liveuser folder with the <tt>--home-size-mb ''NNN''</tt> option. This feature avoids consumption of the write-once persistent overlay for Activity storage (see [[LiveOS image]]) and allows one to update the OS image while keeping the user files (by running the script against your existing installation but <u>leaving out</u> the --home-size-mb NNN option).

 

:: Normally, the ''livecd-iso-to-disk'' installation has the advantage over the ''liveusb-creator'' installation method by allowing a persistent /home/liveuser folder with the <tt>--home-size-mb ''NNN''</tt> option. This feature would allow you to update the OS image while keeping the user files (by running the script against your existing installation but <u>leaving out</u> the --home-size-mb NNN option).

::* The {{Code|--delete-home}} option is used to avoid an error message while requesting both a new home (with {{Code|--home-size-mb}}) and a persistent home (indirectly with {{Code|--unencrypted-home}}). You wouldn't use the --delete-home option on an upgrade of the operation system only.

::* The {{Code|--delete-home}} option is used to avoid an error message while requesting both a new home (with {{Code|--home-size-mb}}) and a persistent home (indirectly with {{Code|--unencrypted-home}}). You wouldn't use the --delete-home option on an upgrade of the operation system only.

:Depending on the size of your USB stick, you may have to decrease {{Code|--overlay-size-mb}} and {{Code|--home-size-mb}} values (for example, for a 1-GB stick, use 300 for the overlay and 175 for the home folder).

:Depending on the size of your USB stick, you may have to decrease {{Code|--overlay-size-mb}} and {{Code|--home-size-mb}} values (for example, for a 1-GB stick, use 300 for the overlay and 175 for the home folder).