Ruby Shell Makefile
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.


Package manager for Chrome OS

Slack Invite Join the chat on Slack

Supported Systems

Architecture Supported?
x86_64 Yes
i686 Yes
armv7l Yes
aarch64 Yes


Chromebooks with Chrome OS run a Linux kernel. The only missing pieces to use them as full-featured Linux distro were gcc and make with their dependencies. Well, these pieces aren't missing anymore. Say hello to chromebrew!


You will need a Chromebook with developer mode enabled. To do so, select your device on the ChromiumOS Wiki and follow the instructions listed there.

Please be aware of the fact that developer mode is insecure if not properly configured. Setting a password as instructed in the VT-2 login screen is essential.


Open the terminal with Ctrl+Alt+T and type shell.

If this command returns ERROR: unknown command: shell please have a second look at the prerequisites and make sure your Chromebook is in developer mode.

Then download and run the installation script below:

wget -q -O - | bash

-- or --

curl -Ls | bash

On a rooted Google OnHub, the command needs to be run with the "chronos" user. In order to make su work, a password is needed for the chronos user.

# passwd chronos
Changing password for chronos.
Enter new UNIX password:
Retype new UNIX password:
# su - chronos
$ curl -Ls -o && yes | bash


crew <command> [-k|--keep] <package1> [<package2> ...]

Where available commands are:

  • build - build package(s) from source and store the archive and checksum in the current working directory
  • const - display constant(s)
  • download - download package(s) to CREW_BREW_DIR (/usr/local/tmp/crew by default), but don't install
  • files - display installed files of package(s)
  • help - get information about command usage
  • install - install package(s) along with dependencies after prompting for confirmation
  • list - available or installed packages
  • remove - remove package(s)
  • search - look for package(s)
  • update - update crew itself
  • upgrade - update all or specific package(s)
  • whatprovides - regex search for package(s) that contains file(s)

Available packages are listed in the packages directory.

Chromebrew will wipe its BREW_DIR (/usr/local/tmp/crew by default) after installation unless you pass -k or --keep when running crew install.

crew install --keep <package1> [<package2> ...]


Copyright 2013-2018 Michal Siwek and all the awesome contributors.

This project including all of its source files is released under the terms of GNU General Public License (version 3 or later).

Our binary packages are hosted on bintray.

Powered by Bintray