Skip to content

Instantly share code, notes, and snippets.

@ladislavsulc
Forked from rachelmyers/Chromebook_setup.md
Created March 4, 2017 22:56
Show Gist options
  • Save ladislavsulc/0e2fbdd3eeef3bc6957f3da444bb912d to your computer and use it in GitHub Desktop.
Save ladislavsulc/0e2fbdd3eeef3bc6957f3da444bb912d to your computer and use it in GitHub Desktop.
How I set up my Chromebooks' dev environment

Chromebook Setup Options

Option 1: Stay in Chrome OS

If you're writing bare-bones javascript for the browser, creating Chrome Apps and Extensions, or using remote coding apps like cloud9, Koding, or Nitrous, you may not need to install Ubuntu. Some tutorials can be done entirely within the browser. The tradeoff is that you won't have a full-featured command line, and you may hit a point where you can't install something that you need.

To start coding within Chrome OS, install Text or Caret as a text editor. (Text stores files in Google Docs and Caret stores the files locally on your machine, which may help you choose.) After that, you're good to go, since Chromebooks come with a browser installed.

Option 2: Install Ubuntu and run a traditional development environment

Enable Developer Mode:

  • Hold down Esc + Refresh + Power to prompt a restart
  • Press Control-D during restart to enter developer mode
  • Press Enter to confirm developer mode and wait to hear a beep; it takes about a minute to reboot from here
  • Complete the setup steps like entering the wifi info and google account
  • If something goes wrong https://github.com/dnschneid/crouton#usage has some troubleshooting help

Download Crouton and your editor:

  • Download Crouton: https://goo.gl/fd3zc (or via https://github.com/dnscheid/crouton), to use Ubuntu on a Chromebook
  • Pro Tip: Download things you'll want to run in Ubuntu before booting into it; the ~/Downloads file is shared, and it's nice to minimize use of the default Ubuntu browser
  • For example, download your editor now; you can get Atom (atom-amd64.deb) from the Atom releases page, though it needs some love to not crash on some ARM Chromebooks. (If you really need to clone down and compile Vim, you'll have to wait until after you have git.)

Install Crouton to start running Ubuntu:

  • Open a chrosh shell: In Chrome, use the shortcut Ctrl + Alt + t, type shell, and hit enter
  • Run sudo sh ~/Downloads/crouton -t xfce to install Ubuntu (assuming it's sitting in your Downloads folder)
  • Start Ubuntu with the command sudo enter-chroot startxfce4 or sudo startxfce4
  • From Ubuntu, you can go back to Chrome OS, by clicking "log out" from the top, left menu

Install apt-get:

  • Open the command prompt
  • Run sudo apt-get update
  • Be more forceful (sudo apt-get -f install) if the update fails

Install Git:

  • sudo apt-get install git, and type Y when it asks to continue
  • sudo apt-get install libnss3-dev, and type Y when it asks to continue

Minimal Git configuration:

  • git config --global user.name "Your Actual Name"
  • git config --global user.email "Your Actual Email"
  • If you want to use a remote, like GitHub, set up SSH keys

Install an editor:

  • If not downloaded, download an editor (atom-amd64.deb from the atom releases page, for example)
  • Run sudo dpkg --install ~/Downloads/atom-amd64.deb to install it
  • To use another editor, repeat those steps (download it and install it) for the editor of your choice

Install Ruby:

  • sudo apt-get install curl
  • command curl -sSl https://rvm.io/mpapis.asc | gpg --import- (because RVM needs to match signatures)
  • curl -L get.rvm.io | bash -s stable to install ruby
  • Close and reopen terminal
  • Confirm rvm is there by running rvm -v and getting good feedback, like ruby 2.2.2, rather than an error
  • Use /bin/bash --login if RVM won't let you set a version.
  • Install and set a default ruby version; this uses 2.2.2 as the example, but change it to fit what you need:
    • rvm install 2.2.2
    • rvm use 2.2.2
    • rvm -- default use 2.2.2

Getting started

  • Install Chrome. (I know, it's weird to reinstall Chrome on a Chromebook. Operating Systems ¯\_(ツ)_/¯)
  • If you're cloning an existing project git clone <whatever you want to clone>
  • If you're starting a new project, then gem install bundler is a good starting point for ruby projects, for example
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment