Difference between revisions of "Installing/Creating Bootable USB"

From GalliumOS Wiki
Jump to: navigation, search
(more pretty. maybe a little overboard. :))
(anything worth doing, is worth doing to excess.)
Line 26: Line 26:
 
# '''Download the GalliumOS ISO''' for your ChromeOS device: https://galliumos.org/download.html
 
# '''Download the GalliumOS ISO''' for your ChromeOS device: https://galliumos.org/download.html
 
# '''Insert USB media''' into Mac OS X machine
 
# '''Insert USB media''' into Mac OS X machine
# '''Carefully determine device path''' for newly inserted USB media from a Terminal.app window<div style="background-color:#404040;color:#00ff00;padding:0.1em 0.5em;width:40em;font-family:monospace;font-size:1.2em"><span style="color:white">bash$ </span>diskutil list</div>The device path will be something like <code>/dev/diskN</code>. Replace <code>N</code> in all steps below with the correct disk number.<div style="background-color:#fff8f8;border:1px solid #cc0000;padding:0.2em 0.5em;width:80%"><span style="font-size:1.2em;font-weight:bold;color:#cc0000;margin:0 0.3em;padding:0.1em 0.3em;background-color:#ffdddd">&#9889;</span>It is '''''extremely''''' important to determine the correct device path for your USB media in this step. Using the wrong device path in the following steps could damage your OS X install and cause irreparable data loss!</div>
+
# '''Carefully determine device path''' for newly inserted USB media from a Terminal.app window<div style="background-color:#404040;color:white;padding:0.1em 0.5em;width:40em;font-family:monospace;font-size:1.2em"><span style="color:#00ff00">bash$ </span>diskutil list</div>The device path will be something like <code>/dev/diskN</code>. Replace <code>N</code> in all steps below with the correct disk number.<div style="background-color:#fff8f8;border:1px solid #cc0000;padding:0.2em 0.5em;width:80%"><span style="font-size:1.2em;font-weight:bold;color:#cc0000;margin:0 0.3em;padding:0.1em 0.3em;background-color:#ffdddd">&#9889;</span>It is '''''extremely''''' important to determine the correct device path for your USB media in this step. Using the wrong device path in the following steps could damage your OS X install and cause irreparable data loss!</div>
# '''Unmount USB media''' from OS X<br><div style="background-color:#404040;color:#00ff00;padding:0.1em 0.5em;width:40em;font-family:monospace;font-size:1.2em"><span style="color:white">bash$ </span>diskutil unmountDisk /dev/disk<span style="color:yellow">N</span></div>
+
# '''Unmount USB media''' from OS X<br><div style="background-color:#404040;color:white;padding:0.1em 0.5em;width:40em;font-family:monospace;font-size:1.2em"><span style="color:#00ff00">bash$ </span>diskutil unmountDisk /dev/disk<span style="color:yellow">N</span></div>
# '''Copy the ISO''' to USB media<br><div style="background-color:#404040;color:#00ff00;padding:0.1em 0.5em;width:40em;font-family:monospace;font-size:1.2em"><span style="color:white">bash$ </span>sudo dd if=<span style="color:yellow">./galliumos.iso</span> of=/dev/rdisk<span style="color:yellow">N</span> bs=1m</div><div style="background-color:#fffff0;border:1px solid #c0c044;padding:0.2em 0.5em;width:80%"><span style="font-size:1.2em;font-weight:bold;color:#888822;margin:0 0.3em;padding:0.1em 0.25em;background-color:#ffffcc">&#x2605;</span>Be sure to use the <code>rdisk</code> device name in the output file (<code>of=</code> parameter), and use the correct path and filename for the <code>galliumos.iso</code> file which you downloaded in step 1.</div>
+
# '''Copy the ISO''' to USB media<br><div style="background-color:#404040;color:white;padding:0.1em 0.5em;width:40em;font-family:monospace;font-size:1.2em"><span style="color:#00ff00">bash$ </span>sudo dd if=<span style="color:yellow">./galliumos.iso</span> of=/dev/<span style="color:#00ff00">r</span>disk<span style="color:yellow">N</span> bs=1m</div><div style="background-color:#fffff0;border:1px solid #c0c044;padding:0.2em 0.5em;margin:0.5em 0 0 0;width:80%"><span style="font-size:1.2em;font-weight:bold;color:#888822;margin:0 0.3em;padding:0.1em 0.25em;background-color:#ffffcc">&#x2605;</span>Be sure to use the <code>rdisk</code> device name in the output file (<code>of=</code> parameter), and use the correct path and filename for the <code>galliumos.iso</code> file which you downloaded in step 1.</div>
# '''Eject USB media''' from OS X<br><div style="background-color:#404040;color:#00ff00;padding:0.1em 0.5em;width:40em;font-family:monospace;font-size:1.2em"><span style="color:white">bash$ </span>diskutil eject /dev/disk<span style="color:yellow">N</span></div>
+
# '''Eject USB media''' from OS X<br><div style="background-color:#404040;color:white;padding:0.1em 0.5em;width:40em;font-family:monospace;font-size:1.2em"><span style="color:#00ff00">bash$ </span>diskutil eject /dev/disk<span style="color:yellow">N</span></div>
 
# '''Remove USB media''' from Mac OS X machine, it's now ready for your ChromeOS device
 
# '''Remove USB media''' from Mac OS X machine, it's now ready for your ChromeOS device
  

Revision as of 20:20, 7 December 2015

Creating bootable GalliumOS media is very similar to other Linux distributions. Unfortunately, that doesn't mean it's easy. The goal of this guide is to make it as straightforward as possible.

On Linux

First, you need to download the GalliumOS iso for your Chromebook.

Once the iso is finished downloading (you MUST wait for it to finish), open up your favourite Terminal emulator.

cd to the place where you downloaded the iso. It's probably ~/Downloads.

cd ~/Downloads

Plug in your USB device, identify it, and unmount it. This is a little tricky. You can use lsblk to get a list of storage devices attatched to your system. Try to find out which one is your USB flash drive. It is very important to not get this wrong, as it could cause catastrophic data loss. Once you've figured it out, make sure the USB flash drive is unmounted.

sudo umount -f /dev/sdb1

Be sure to replace sdb1 with the actual partition name as listed in lsblk. Next, use dd to copy the ISO to the USB flash drive.

dd bs=1M if=galliumos.iso of=/dev/sdb

Be sure to replace galliumos.iso with the filename of the iso you want to write. Usually typing "galliumos" and hitting tab will autocomplete it for you. Also be sure to replace sdb with the actual device as listed in lsblk. Make sure to write to the DEVICE and NOT the partition. This process can take a long time depending on the speed of your flash drive, USB connection, and hard drive. Be patient. Once the prompt comes back, the ISO should be written. If you're getting errors, try adding sudo to the beginning of the command. Before you unplug your flash drive, be sure to run sync


On Mac OS X

  1. Download the GalliumOS ISO for your ChromeOS device: https://galliumos.org/download.html
  2. Insert USB media into Mac OS X machine
  3. Carefully determine device path for newly inserted USB media from a Terminal.app window
    bash$ diskutil list
    The device path will be something like /dev/diskN. Replace N in all steps below with the correct disk number.
    It is extremely important to determine the correct device path for your USB media in this step. Using the wrong device path in the following steps could damage your OS X install and cause irreparable data loss!
  4. Unmount USB media from OS X
    bash$ diskutil unmountDisk /dev/diskN
  5. Copy the ISO to USB media
    bash$ sudo dd if=./galliumos.iso of=/dev/rdiskN bs=1m
    Be sure to use the rdisk device name in the output file (of= parameter), and use the correct path and filename for the galliumos.iso file which you downloaded in step 1.
  6. Eject USB media from OS X
    bash$ diskutil eject /dev/diskN
  7. Remove USB media from Mac OS X machine, it's now ready for your ChromeOS device

On Windows

Windows is a little tricky. I will write a few guides once I have access to a Windows box.


On ChromeOS

ChromeOS is very similar to Linux, but noy identical. I will write a proper guide as soon as I have access to a Chromebook (that I haven't installed GalliumOS on :P)