the Chromium logo

The Chromium Projects

Using Chromium OS SDK as standalone, DIY

This page describes how to use the Chromium OS SDK as standalone package, without anything on top.

Target audience

For the most part, you should know what you're doing to go this way.

Provided by the SDK

NOTE: It is not possible to switch toolchains or install new ones, as well as generally update the system in any way. If you want a newer version, delete all and start over.

Installation instructions

Getting the SDK

The latest version of SDK can be located in chromiumos-overlay.git repository, in sdk_version.conf

The individual SDK tarballs can be found in the Google Storage mirror:

In order to download the latest SDK automatically, you can execute:

eval $(curl -s | base64 -d | grep '^SDK_LATEST_VERSION=')
wget "${SDK_LATEST_VERSION}.tar.xz"

Unzipping & entering SDK

Unzip the SDK to a folder of your choice, for example "./sdk":

mkdir sdk
cd sdk
tar xvf ../cros-sdk-${SDK_LATEST_VERSION}.tar.xz

Set up some mounts:

mount -t proc proc ./proc
mount -t sysfs sysfs ./sys

Enter by using chroot:

sudo chroot . /bin/bash

Optional: setting up various environment bits prior to chroot

These are mostly optional and depend on what do you want to do inside the chroot. For merely running gcc, you should need neither.

  1. Mimic host network configuration: sudo cp /etc/resolv.conf /etc/hosts sdk/etc/ This usually needs to be done only once unless your host's network is dynamic.
  2. Bind /dev, if you're going to be working with any devices: sudo mount -o bind /dev sdk/dev
  3. Make a copy or bind-mount of any configuration/data you will need inside the chroot.

Remember to clean up the chroot (especially) from mounts after you stop using it.