Skip to content
Package manager for Chrome OS
Ruby Shell
Branch: master
Clone or download
Pull request Compare This branch is 2792 commits behind skycocker:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


Package manager for Chrome OS

Supported Systems

Architecture Supported?
x86_64 Yes
i686 Yes
armv7l Yes
aarch64 Yes (use armv7l binaries)


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.

On the ChromiumOS Wiki select your device and follow the instructions listed there.

Please be aware of the fact that developer mode is insecure if not properly configured.


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

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

passwd chronos
# Choose your password
su - chronos
curl -L | bash
# When prompt, use the password you just created for "chronos" user.


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]
  • download [download package(s) to CREW_BREW_DIR (/usr/local/tmp/crew by default), but don't install]
  • help [get information about command usage]
  • install [install package(s) along with dependencies after prompting for confirmation]
  • remove [remove package(s)]
  • search [look for a package]
  • 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 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).

You can’t perform that action at this time.