Difference between revisions of "Installing"

From GalliumOS Wiki
Jump to: navigation, search
 
(25 intermediate revisions by 8 users not shown)
Line 1: Line 1:
This page covers the basics of installing GalliumOS. There are two basic ways to do this. You can install from a USB flash drive or SD card, which will allow you to use your whole SSD or HDD for GalliumOS, along with other more complicated configurations, such as dualbooting with Windows or other Linux distributions. You can also use chrx, which is a user friendly script written by [[User:reynhout]] that will allow you to dualboot GalliumOS and ChromeOS on the same computer with relative ease.
+
==  General Install Instructions ==
 +
There are two methods for installing GalliumOS:
 +
# '''From an ISO image on a USB drive or SD card'''<br>This method enables you to entirely replace ChromeOS on your Chromebook's internal storage (SSD, eMMC, or NVMe).<br>It also allows the possibility of more complex configurations such as dual-booting alongside Windows or other Linux distributions (these are outside of the scope of these instructions however).
 +
# '''From the ChromeOS command-line using chrx'''<br>This method will configure your device to dual-boot GalliumOS alongside ChromeOS. chrx can install GalliumOS to your Chromebook's internal storage, as well as to external USB/SD devices.
  
 +
See [[Hardware Compatibility]] to verify the requirements, limitations, and installation options available for your ChromeOS device model.
  
== Traditional ISO Install ==
+
=== 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 also use GalliumOS Live to try out the features of GalliumOS before you even install it!
+
The traditional ISO install method allows you to use your entire SSD or HDD for GalliumOS. You will need to use a USB flash drive or SD card, and your Chromebook will need to support either Legacy Boot Mode or have UEFI firmware available. You can even boot the GalliumOS Live image to try out the features of GalliumOS before you decide to install!
  
# Go to [[Preparing for GalliumOS]] and get your Chromebook ready to run GalliumOS.
+
# Go to [[Installing/Preparing]] and get your Chromebook ready to run GalliumOS
# Download a GalliumOS ISO from the [https://galliumos.org/download.html downloads page on GalliumOS.org]
+
# [https://galliumos.org/download Download] the appropriate GalliumOS ISO for your device
# Write (or "burn") the ISO to a USB flash drive or an SD card. Detailed instructions for this are at [[Making GalliumOS Bootable Media]]
+
# Write (or "burn") the ISO to a USB flash drive or an SD card
 +
#* Detailed instructions at [[Installing/Creating Bootable USB]]
 
# Plug your USB flash drive or SD card into your Chromebook
 
# Plug your USB flash drive or SD card into your Chromebook
# Reboot your Chromebook and boot from the USB flash drive or SD card.
+
# Reboot your Chromebook and boot from the USB flash drive or SD card
## If you have custom firmware, press Esc at the BIOS screen and press 2 to boot from USB.
+
#* If you have the white "OS verification is OFF" screen, press <code>Ctrl</code>+<code>L</code>
## If you have the scary white screen, press Ctrl+L.
+
#* If you have installed custom firmware, press Esc at the BIOS screen and select the USB device
# 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.
+
# 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 <code>Ctrl</code>+<code>L</code> to 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), and you allow your battery to drain completely, you might have a problem booting GalliumOS. This is due to the Developer Mode boot flag enabling Legacy Boot mode being reset when power is lost - see [https://wiki.galliumos.org/Firmware#crossystem crossystem flags]. 
  
== GalliumOS on chrx ==
+
This is easily fixable, but it's preferable 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]]
  
GalliumOS is installable via chrx, a user friendly script written by [[User:reynhout]] that will allow you to dualboot GalliumOS and ChromeOS on the same computer with relative ease. Please note that chrx is only possible on Haswell and Broadwell Chromebooks, and some Chromebooks may require additional tweaking to make it work. The original Chromebook Pixel should also be supported dispite it being an Ivy Bridge.
+
=== chrx Installation ===
  
 +
Installing GalliumOS via [https://chrx.org/ chrx] allows you to dual-boot GalliumOS alongside ChromeOS. Check the [https://chrx.org/#compatibility chrx hardware compatibility list] to see if your device supports chrx, and whether any preparation steps are required.
  
Installing GalliumOS via [https://chrx.org/ chrx] will allow you to run a dualboot, with GalliumOS and ChromeOS, allowing you to choose between them at boot.
+
See [https://chrx.org#usage chrx installation instructions] for full details, but here's a quick overview:
  
Note that chrx only works with certain Chromebook models, so be sure to review the [https://chrx.org/#compatibility hardware compatibility list].
+
# 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 <code>Ctrl</code>+<code>Alt</code>+<code>F2(top row right arrow)</code>, then log in as user <code>chronos</code> with no password
 +
# Run chrx: <code>cd ; curl -O <nowiki>https://chrx.org/go</nowiki> && sh go</code> (see [https://chrx.org/#options 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 <code>Ctrl</code>+<code>L</code> for GalliumOS, or <code>Ctrl</code>+<code>D</code> for ChromeOS
  
# Follow the steps are [[Preparing for GalliumOS]] to make sure your Chromebook is ready to boot GalliumOS.
+
== Additional Software ==
# Boot up and log in to your Chromebook, and connect to the internet. Make sure you have a good stable internet connection.
+
[[Additional_Software|Additional Software for GalliumOS]]
# Press Ctrl+Alt+T to open up a crosh session. Type <code>shell</code> and press enter to start bash.
+
 
# Run chrx
+
== Developer Installation ==
## <code>curl -O <nowiki>https://chrx.org/go</nowiki> && sh go -d galliumos</code>
+
 
## You can add more options to the end to customize your install. See [https://chrx.org/#options the chrx documentation] for more information.
+
You can install GalliumOS as a virtual machine in order to do user-space software development and testing. Obviously hardware-specific issues will not be debuggable in these environments.
# Follow on-screen instructions to repartition your SSD and install GalliumOS. Be patient, it may take quite a while depending on your internet connection and SSD speed.
+
 
# When it's all done, reboot your Chromebook. Now you can press Ctrl+D at the scary white screen to boot to ChromeOS, or Ctrl+L to boot to GalliumOS.
+
* [[Installing/VirtualBox | VirtualBox]]
 +
* [[Installing/VMWareFusion | VMWare (Fusion)]]

Latest revision as of 02:53, 8 April 2020

General Install Instructions

There are two methods for installing GalliumOS:

  1. From an ISO image on a USB drive or SD card
    This method enables you to entirely replace ChromeOS on your Chromebook's internal storage (SSD, eMMC, or NVMe).
    It also allows the possibility of more complex configurations such as dual-booting alongside Windows or other Linux distributions (these are outside of the scope of these instructions however).
  2. From the ChromeOS command-line using chrx
    This method will configure your device to dual-boot GalliumOS alongside ChromeOS. chrx can install GalliumOS to your Chromebook's internal storage, as well as to external USB/SD devices.

See Hardware Compatibility to verify the requirements, limitations, and installation options available for your ChromeOS device model.

Traditional ISO Install

The traditional ISO install method allows you to use your entire SSD or HDD for GalliumOS. You will need to use a USB flash drive or SD card, and your Chromebook will need to support either Legacy Boot Mode or have UEFI firmware available. You can even boot the GalliumOS Live image to try out the features of GalliumOS before you decide to install!

  1. Go to Installing/Preparing and get your Chromebook ready to run GalliumOS
  2. Download the appropriate GalliumOS ISO for your device
  3. Write (or "burn") the ISO to a USB flash drive or an SD card
  4. Plug your USB flash drive or SD card into your Chromebook
  5. Reboot your Chromebook and boot from the USB flash drive or SD card
    • If you have the white "OS verification is OFF" screen, press Ctrl+L
    • If you have installed custom firmware, press Esc at the BIOS screen and select the USB device
  6. 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
  7. After reboot, press Ctrl+L to 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), and you allow your battery to drain completely, you might have a problem booting GalliumOS. This is due to the Developer Mode boot flag enabling Legacy Boot mode being reset when power is lost - see crossystem flags.

This is easily fixable, but it's preferable 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

chrx Installation

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:

  1. Prepare your ChromeOS device: see Installing/Preparing
  2. Boot device into ChromeOS and configure networking; you do not need to log in
  3. Switch to a virtual terminal by pressing Ctrl+Alt+F2(top row right arrow), then log in as user chronos with no password
  4. Run chrx: cd ; curl -O https://chrx.org/go && sh go (see chrx docs for additional options)
  5. 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.
  6. After reboot, at the white "OS verification is OFF" screen, press Ctrl+L for GalliumOS, or Ctrl+D for ChromeOS

Additional Software

Additional Software for GalliumOS

Developer Installation

You can install GalliumOS as a virtual machine in order to do user-space software development and testing. Obviously hardware-specific issues will not be debuggable in these environments.