General Install Instructions
You have two possible options for installing GalliumOS:
- From an ISO image on a USB drive or SD card
This method enables you to entirely replace ChromeOS on your internal SSD or HDD.
It also allows you to set up more complex configurations such as dual-booting alongside Windows or other Linux distributions.
- From the ChromeOS command-line using chrx
This method will configure your device to dual-boot GalliumOS alongside ChromeOS.
See Hardware Compatibility for the installation options available for your ChromeOS device model.
Traditional ISO Install
The traditional installer allows you to use your entire SSD or HDD for GalliumOS. You will need to use a USB flash drive or SD card. You can even boot the GalliumOS Live image to try out the features of GalliumOS before you decide to install!
- Go to Installing/Preparing and get your Chromebook ready to run GalliumOS.
- Download a GalliumOS suitable for your device ISO from the downloads page on GalliumOS.org
- Write (or "burn") the ISO to a USB flash drive or an SD card. Detailed instructions for this are at Installing/Creating Bootable USB
- Plug your USB flash drive or SD card into your Chromebook
- Reboot your Chromebook and boot from the USB flash drive or SD card.
- If you have installed custom firmware, press Esc at the BIOS screen and press 2 to boot from USB.
- If you have the scary white screen, press
- Wait for GalliumOS to boot up. Once in the live environment you can play around with GalliumOS, or you can install it using the Install GalliumOS icon on the desktop.
- After reboot, press
Lto access GalliumOS (this requirement can be bypassed for single-boot on most models, see Firmware).
Important: If you choose an ISO install of GalliumOS (thus removing ChromeOS), and choose to use the Legacy Boot Mode of the stock firmware (ie, with the stock or updated RW_LEGACY firmware), you will no longer be able to boot GalliumOS if the device's internal battery runs down or is disconnected. This is due to the Developer Mode boot flag enabling Legacy Boot mode being reset when power is lost - see crossystem flags.
While recovery is possible after the fact, it's far, far easier to avoid the issue entirely by either setting the corresponding firmware boot flag (which is not reset when power is lost), or by flashing custom Full ROM firmware - see Firmware
Installing GalliumOS via chrx allows you to dual-boot GalliumOS alongside ChromeOS. Check the chrx hardware compatibility list to see if your device supports chrx, and whether any preparation steps are required.
See chrx installation instructions for full details, but here's a quick overview:
- Prepare your ChromeOS device: see Installing/Preparing
- Boot device into ChromeOS and configure networking; you do not need to log in
- Switch to a virtual terminal by pressing
F2(top row right arrow), then log in as user
chronoswith no password
- Run chrx:
curl -O https://chrx.org/go && sh go(see chrx docs for additional options)
- Follow on-screen prompts to repartition your SSD and install GalliumOS. If this is the first time running chrx on this ChromeOS machine, chrx will reboot after the partitioning step and you will need to continue the installation by running chrx again with the same command line.
- After reboot, at the white "OS verification is OFF" screen, press
Lfor GalliumOS, or
Specific Device Install Documents
Our community is also making in-depth install guides for certain devices. Below is a list.