Chromebook install instructions

From Tekkotsu Wiki

Revision as of 21:15, 5 July 2016 by Touretzky (Talk | contribs)
(diff) ← Older revision | Current revision (diff) | Newer revision → (diff)
Jump to: navigation, search

This page will take you through the steps to install Ubuntu Linux on a Chromebook. You'll be running Ubuntu under the Crouton Virtual Machine.


Turn on Developer Mode

  1. Hold down the Escape and Refresh keys and tap the power button.
  2. Ignore the "Chrome OS is missing or damaged" message if it apepars.
  3. Type control-D, then hit Enter to turn off OS vertification.
  4. Wait 30 seconds.
  5. The system will start preparing for Developer Mode.
  6. Wait about six minutes to transition to Developer Mode.
  7. You will get the Chrome login screen with the mountain/beach background.

Install the Crouton VM

  1. Establish a network connection.
  2. Click "Browse as guest".
  3. Download the install script by visiting
  4. Go to the crosh developer console by typing control-alt-T in the browser.
  5. Type "shell" to get a shell.
  6. Run the install script by typing: sudo sh ~/Dowloads/crouton -r trusty -t unity -e
  7. sudo will demand a password. Use "facepunch".
  8. Specify an encryption passphrase of "passphrase".
  9. Wait about 25 minutes for Ubuntu to install.
  10. Specify user name "calliope", password "tekkotsu".
  11. type "sudo startunity" and enter the password "facepunch" and then the passphrase "passphrase".
  12. When you see the Ubuntu desktop, type control-alt-T to get a terminal window.
  13. Type: sudo adduser calliope dialout
  14. Type sudo apt-get install ubuntu-desktop
  15. After installation completes, log out, which will kill the Linux virtual machine.
  16. Do "sudo startunity" to start Ubuntu again. Same password and passphrase as above.
  17. Click on the Settings icon in the dock at left, then select Brightness & Lock, and turn off screen lock.
  18. Also turn off "require password after suspend".
  19. Right click on all the disk drive icons in the dock and select "Unlock from Launcher".

Complete the Ubuntu Configuration Steps

To complete the configuration of Ubuntu for Tekkotsu, follow the Ubuntu install instructions for workstations and laptops.

Skip the preliminary instructions about installing Ubuntu (you've already done that) and start at the instruction for applying software updates. Any references to "user" or "/home/user" should be replaced with "calliope" or "/home/calliope".

Additional configuration steps for Ubuntu to allow access to serial ports:

sudo adduser calliope serial

Note: You will need to log out and log back in again for the adduser to take effect.

When you're installing Tekkotsu and it's time to edit the Environment.conf file, use TGT_CALLIOPE3A.

Click here to begin: Ubuntu install instructions

Disable Chrome OS Port Blocking

After Ubuntu is installed, add the iptables package to control port blocking:

apt-get install iptables

Then add the following lines to /etc/rc.local:

/sbin/iptables -P INPUT ACCEPT
mkdir -p -m0755 /var/run/sshd

For these commands to take effect immediately you must do:

sudo source /etc/rc.local

Powering Up the Chromebook Once Linux Has Been Installed

You must keep the Chromebook in Developer Mode to run Linux. If you allow the Chromebook to restore Chrome OS you will lose your Ubuntu installation and all the files stored in your Ubuntu virtual machine. Therefore, you must be very careful when powering up the Chromebook; hitting Space at the wrong time can be fatal. Follow these steps:

  1. Press the Power button.
  2. You will get a message saying "Chrome OS is missing or damaged".
  3. Do not hit the Space bar!!!
  4. Type control-D, or just wait.
  5. Chrome will boot and you'll see the mountain/beach background.
  6. Click on "Browse as Guest" at the bottom.
  7. Type "shell" to get a ChromeOS shell.
  8. To the shell prompt, type "sudo startunity" to start Ubuntu.