Installing/Creating Bootable USB - Revision history

Crystal: remove dead youtube link

2022-01-10T13:27:27Z

remove dead youtube link

Reynhout at 00:15, 12 September 2019

2019-09-12T00:15:41Z

Reynhout: /* On Windows (Traditional) */

2019-09-12T00:10:05Z

‎On Windows (Traditional)

Reynhout: /* Testing your USB drive and write */

2018-07-19T16:08:40Z

‎Testing your USB drive and write

Reynhout: /* Troubleshooting */

2018-07-19T16:05:45Z

‎Troubleshooting

Reynhout: /* On Windows (Traditional) */

2018-01-11T15:37:28Z

‎On Windows (Traditional)

Reynhout: /* On Windows (Traditional) */

2018-01-04T16:59:38Z

‎On Windows (Traditional)

Reynhout at 21:29, 26 July 2017

2017-07-26T21:29:21Z

Reynhout: /* On Linux (Traditional) or ChromeOS */

2017-07-26T21:28:18Z

‎On Linux (Traditional) or ChromeOS

Reynhout: /* On Linux (Traditional) */

2017-07-26T21:27:57Z

‎On Linux (Traditional)

← Older revision		Revision as of 13:27, 10 January 2022
Line 4:		Line 4:

	Etcher is an excellent tool for writing the ISOs to bootable USBs because it is fast, easy to use, and it automatically verifies the integrity of the image after writing it.		Etcher is an excellent tool for writing the ISOs to bootable USBs because it is fast, easy to use, and it automatically verifies the integrity of the image after writing it.
−
−	~~'''If you would like a video to follow along with''', I've made this one, which I believe to explain the process very well: https://www.youtube.com/watch?v=Pv0WansPmLs~~

	Before you get started, '''download the correct version of GalliumOS for your device''' from https://galliumos.org/download If you don't know which version you need, check out the [[Hardware Compatibility]] page.		Before you get started, '''download the correct version of GalliumOS for your device''' from https://galliumos.org/download If you don't know which version you need, check out the [[Hardware Compatibility]] page.

@@ Line 24: / Line 24: @@
 == On ChromeOS or Linux (Traditional) ==
 # First, you need to download the GalliumOS iso for your Chromebook.
@@ Line 57: / Line 62: @@
 * '''Do not use YUMI'''
 * '''Do not use ISO to USB'''
 </div>

@@ Line 57: / Line 57: @@
 * '''Do not use YUMI'''
 * '''Do not use ISO to USB'''
 </div>

@@ Line 98: / Line 98: @@
 === Testing your USB drive and write ===
-You can verify your image, as-written to USB/SD. This is often different from the image saved to the ISO file, which always indicates a problem! The steps are a bit more complicated, and sometimes need to be repeated more than once to identify an intermittently-failing USB/SD storage device:
+You can verify your image, as-written to USB or SD media. This is often different from the image saved to the ISO file, which always indicates a problem!
      # Verify the ISO image, as-written to USB or SD media
      # Replace "galliumos.iso" with the path to your ISO file
      # Replace "/dev/sdb" with the device path of your USD or SD media.
@@ Line 111: / Line 114: @@
      sudo head -c "$ISO_SIZE" "$ISO_MEDIA" | md5sum
-This should return an MD5 result which matches the published value, and also the results of the check of the ISO file itself.
+This should return an MD5 result which matches the published value, and also matches the results of the check of the ISO file itself (described above).
 Additionally, the GalliumOS ISO should boot any x86 computer. This is a safe test -- booting from the ISO launches a "Live" demo environment, which does not (automatically) attempt to install any software. This will only identify failed writes that impact booting, of course.
 If all else fails, you might have better luck using chrx to install GalliumOS in a dual-boot config, which downloads directly from the GalliumOS servers, and does not require any installation media.

@@ Line 83: / Line 83: @@
 There are many things that can go wrong. Some errors are immediately obvious (won't boot), others can be very surprising (installer crash, IO errors). If you're having trouble, consider this list of possibilities:
-=== Common Problems ===
+=== (Very) Common Problems ===
 * '''Mistaken write''': Human error happens! Please reread the instructions very carefully -- make sure you're writing to the correct device, and to the correct device file (which is different from the device file in other commands).
 * '''Corrupt write''': We frequently see corrupt writes to USB/SD media even when all steps are followed correctly. Sometimes the second or third try "just works", but confirm the MD5 checksum first.
 * '''Bad USB/SD media''': These devices aren't known for their reliability. Try a different USB drive or SD card if you are able.
 === Less-Common Problems ===
@@ Line 94: / Line 93: @@
 ** macOS: <code>md5 ./galliumos.iso</code>
 ** Windows: https://www.microsoft.com/en-us/download/details.aspx?id=11533
 * '''Bad image''': Sometimes we make bad nightly images! It's rare, but it has happened. Please let us know if you run into this problem. The ISOs linked from the [https://galliumos.org/download GalliumOS download page] are well-tested, so try one of those instead.
 === Testing your USB drive and write ===
-The GalliumOS ISO should boot any x86 computer that allows "Legacy Boot" (this might require config in the BIOS menu). This is a safe test -- booting from the ISO launches a "Live" demo environment, which does not (automatically) attempt to install any software.
+You can verify your image, as-written to USB/SD. This is often different from the image saved to the ISO file, which always indicates a problem! The steps are a bit more complicated, and sometimes need to be repeated more than once to identify an intermittently-failing USB/SD storage device:
-If all else fails, you might have better luck installing in a dual-boot config, which downloads directly from the GalliumOS servers, and does not require any installation media.
+If all else fails, you might have better luck using chrx to install GalliumOS in a dual-boot config, which downloads directly from the GalliumOS servers, and does not require any installation media.

@@ Line 56: / Line 56: @@
 * '''Do not use UNetbootin'''
 * '''Do not use YUMI'''
 </div>

@@ Line 53: / Line 53: @@
 <div style="padding:0.2em; background-color:#ffffcc; border:1px solid #cccc88">
 * We recommend '''Etcher''' (see above) or '''Win32DiskImager''' (see below)
-* '''Rufus''' is also fine, but '''be sure to select <code>dd mode</code>'''
+* '''Rufus''' is also fine, but '''be sure to select <code>"Write in DD-Image mode"</code>'''
 * '''Do not use UNetbootin'''
 * '''Do not use YUMI'''

← Older revision		Revision as of 21:29, 26 July 2017
Line 75:		Line 75:

	'''If you are unable to boot your ChromeOS device using your new USB media, see [[Installing/Creating Bootable USB#Troubleshooting\|Troubleshooting]], below.'''		'''If you are unable to boot your ChromeOS device using your new USB media, see [[Installing/Creating Bootable USB#Troubleshooting\|Troubleshooting]], below.'''
−
−	~~== On ChromeOS ==~~
−
−	~~ChromeOS is very similar to Linux, but not identical. I will write a proper guide as soon as I have access to a Chromebook (that I haven't installed GalliumOS on :P)~~

	== Troubleshooting ==		== Troubleshooting ==

@@ Line 23: / Line 23: @@
 '''If you are unable to boot your ChromeOS device using your new USB media, see [[Installing/Creating Bootable USB#Troubleshooting|Troubleshooting]], below.'''
-== On Linux (Traditional) or ChromeOS ==
+== On ChromeOS or Linux (Traditional) ==
 # First, you need to download the GalliumOS iso for your Chromebook.