Friday, May 31, 2013

ChrUbuntu: One Script to Rule Them All!

Update: If you want to run ChrUbuntu on a Chromebook Pixel or one of the new Haswell-based Chromebooks like the HP Chromebook 14 or Acer C720, please take a look at the newer script that offers a better way to dual boot.

Update: I'm aware that the script isn't working on Cr-48s, Samsung Series 5 and Acer C700 first gen Chromebooks but no longer have any of those to do testing with. For now, use the older 12.04 script on those models and upgrade to 13.10 if you want using the normal Ubuntu upgrade instructions.

I'm excited to announce a major update to the ChrUbuntu script. This new version offers:
  • A single script that works on ALL Chrome devices including the ARM-based Samsung Chromebook.
  • A single script that can install any Ubuntu version: 13.10, 12.04.3 LTS, even the latest daily dev image. (Note: ARM Chromebook is currently limited to 12.04.3 as newer versions are broken on ARM)
  • A single script that can install UbuntuKubuntuLubuntuXubuntuEdubuntu or many other desktop variants.
  • A fully up-to-date ChrUbuntu install on boot. No more downloading hundreds of megabytes in updates after first boot.
To make all of this possible, I've rewritten the ChrUbuntu script to pull packages directly from official ubuntu.com sources rather than utilizing my own pre-configured, static image of an Ubuntu installation.


Want to say thank you for ChrUbuntu? Feel free to do so in the comments below, via PayPal or by visiting the advertisements on this blog. If you purchase a Chromebook or any other Amazon.com items using these links, you pay the same price but a portion of the cost goes to support this blog.

Ready to get started with the latest, greatest ChrUbuntu? Here are the instructions:
  1. To get started, make sure your Chromebook is in developer mode and has a developer BIOS installed. See Google's instructions for your model. Older Samsung and Acer owners should pay special attention to the Developer BIOS instructions.
  2. Start with your Chrome device turned off. Turn it on but do not login. Make sure you have a WiFi or Ethernet connection configured at this point. 3G/4G is not recommended. Press CTRL+ALT+=> (=> is the forward arrow where the F2 key would be on a PC). Do not use the normal CTRL+ALT+T method to get a shell. Use the CTRL+ALT+=> method while no one is logged in.
  3. Login as user chronos, no password is needed.
  4. As the chronos user and without having changed directories or run other commands, run:

    curl -L -O http://goo.gl/s9ryd; sudo bash s9ryd

    Make sure you have the command exactly right. The -O and -L after curl are both capital letters. s9ryd is all lowercase letters and numbers and would sound like "ess nine are why dee" if you said it out loud. If you get a "not found" error, make sure you have Internet connectivity and you're typing the command correctly.
  5. You'll be prompted with some information about your Chromebook. You may need to run an additional command to install a developer BIOS on your Chromebook. Press Enter to continue.
  6. The Chrome OS stateful partition where your data and settings are stored is just short of 11gb by default (except for the Acer C7 where it is much larger), the script shrinks the stateful partition to make room for ChrUbuntu. You can choose to give ChrUbuntu from 5gb up to 10gb in 1gb increments (Note: If you've installed a larger SSD in your Chrome device, your max number and recommended max will be larger). I recommend not going higher than 9 as 10 leaves Chrome OS with very little free space (less than 1gb).
  7. Once you've entered a number, your hard drive will be repartitioned. After awhile it will reboot and re-initialize the stateful partition. This process takes 2-15 minutes and then the Chromebook reboots again and shows you the Welcome screen you got when you first turned on your Chromebook out of the cardboard box.
  8. Go through the Chrome OS setup process again until you get to the Google login page. You'll need to have a WiFi or Ethernet connection again at this point. Now follow steps 2 through 4 again. This time the script will see that you've already made room for Ubuntu and start downloading ChrUbuntu.

    Pro Tip: Here's where you can install other versions of Ubuntu! Just specify the preferred Ubuntu flavor and version at the end of the command:

    curl -L -O http://goo.gl/s9ryd; sudo bash s9ryd [flavor] [version] [target-disk]

    For example:

    curl -L -O http://goo.gl/s9ryd; sudo bash s9ryd xubuntu-desktop lts

    this will install Xubuntu and the latest LTS release (12.04.3 as of writing) rather than a 13.10 Unity desktop. Some possible flavor alternatives to Unity are:

    default  (ubuntu-desktop on x86, xubuntu-desktop on arm)
    kubuntu-desktop
    lubuntu-desktop
    xubuntu-desktop
    edubuntu-desktop
    ubuntu-standard
        (no GUI installed)

    some possible versions are:

    lts -- latest LTS Ubuntu release, 12.04.3 as of this writing
    latest -- latest official release, currently 13.10
    dev -- unstable development Ubuntu release, experts only! If this breaks, don't be surprised
    12.10 -- Ubuntu 12.10 release

    [target-disk] is the last argument (specify "default" and "latest" for the first two arguments if you just want to install the defaults to an external drive). An example installation to SD Card might be:

    curl -L -O http://goo.gl/s9ryd; sudo bash s9ryd default latest /dev/mmcblk1
  9. During the installation (within the first 5-15 minutes). You'll see a few prompts to select your encoding, locale and language. For most people, the defaults should be fine, just press Enter but change them if you'd like.
  10. After all of the Ubuntu files have been downloaded, installed and configured, the script will make a few more updates and then prompt you to reboot.
  11. You'll see ChrUbuntu start up! The username is "user" and the password is "user".
  12. Right now, you're in ChrUbuntu but if you reboot, you'll be back in Chrome OS. This is a safety feature, if ChrUbuntu won't boot, you want to be able to get back into Chrome OS to fix it. To make ChrUbuntu the default, run:

    sudo cgpt add -i 6 -P 5 -S 1 /dev/sda

    on the ARM Chromebook, replace /dev/sda with /dev/mmcblk0. The password is "user". It should be possible to run this from ChrUbuntu or Chrome OS.

    To make Chrome OS the default again, either turn off Developer Mode, or run:

    sudo cgpt add -i 6 -P 0 -S 1 /dev/sda