/elementaryos-chromebook

ChromeeOS - elementary OS installation script for Chromebooks

Primary LanguageShellGNU Lesser General Public License v3.0LGPL-3.0

ChromeeOS - elementary OS installation script for Chromebooks

ChromeeOS will install elementary OS (with ChrUbuntu) and apply automatically all the necessary fixes to run elementary OS on Chromebooks. You will be able to boot in ChromeOS or elementary OS on your Chromebook.

Supported device(s)

  • Acer C720 (Tested)
  • HP Chromebook 14 (Untested, but should work using the Acer C720 device profile)
  • Asus Panther Chromebox (Tested)

Prerequisites

  • A Chromebook listed in the supported device(s) section
  • A recovery image for you Chromebook in case something goes wrong. In order to achieve that, go to chrome://imageburner, on your Chromebook, and follow the instructions
  • Chromebook in developer mode
  • An external media of at least 1GB (USB Flash drive or SD Card)
  • Patience

Usage

ATTENTION: This will wipe everything on your device

ATTENTION: This is still a pre-release, there could be bugs

  1. Enable developer mode on your device
  2. Download the latest pre-release of ChromeeOS and extract it to a removable media
  3. Boot into ChromeOS, connect to a wireless network and log in as guest
  4. Open a shell (CTRL + ALT + t) and type shell
  5. From the shell go to the location of the script on the removable media cd /media/removable/ and press [TAB] [TAB] on your keyboard to show and auto-complete your removable media path automatically
  6. Run the script with the list parameter to list the supported device(s) sudo bash main.sh list or the search parameter to search in all devices profile(s) sudo bash main.sh search DEVICE_PROFILE (ex: sudo bash main.sh search acer)
  7. Run the script with the appropriate manifest for your device sudo bash main.sh DEVICE_PROFILE (ex: sudo bash main.sh acer-c720)
  8. On the first run you will be asked how much storage space you want to dedicate to elementary OS
  9. After the first run, your system will reboot to complete the initial formating, then you will need to re-run the script with the same parameters to complete the installation process
  10. Follow the prompt to complete the installation
  11. After the installation is completed and the Chromebook has rebooted, press CTRL+L to boot into elementary OS
  12. On first boot you will be asked to complete your system configuration (Language, Time zone, Computer name) and create a user account

Credit(s)

  • The elementary OS development team for creating this awesome Linux distribution
  • Parimal Satyal for making a guide on how to install elementary OS on the HP Chromebook 14
  • Jay Lee for creating ChrUbuntu from which I use a modified version
  • SuccessInCircuit on reddit for making a guide on how to fix mostly everything with the Acer C720
  • Benson Leung for his cros-haswell-modules script
  • Quatral Solutions for providing the Acer C720 Chromebook
  • Jesus Lopez - Thanks for helping testing ChromeeOS for the Asus Chromebox
  • Everyone who contributed