Establish a Build Environment

This article needs a technical review. How you can help.

Before downloading the code to build Firefox OS, you need to configure your build system — this page shows you how. You can currently build on 64-bit Linux distributions and OS X.

Requirements for a Linux build environment

To build on Linux, you need:

  • A 64 bit Linux distribution.
  • At least 4 GB of RAM.
  • At least 40 GB of available hard disk space.

Ubuntu 14.04 LTS is tested and recommended.

Install required packages

sudo apt-get install git-core gnupg flex bison gperf build-essential \
     zip curl zlib1g-dev gcc-multilib g++-multilib libc6-dev-i386 \
     lib32ncurses5-dev x11proto-core-dev libx11-dev lib32z-dev ccache \
     libgl1-mesa-dev libxml2-utils xsltproc unzip autoconf2.13 lzop

Configure USB access

On Linux systems, a regular user can't directly access USB devices by default. You need to configure udev rules. Create a file at /etc/udev/rules.d/51-android.rules with the following command:

wget -S -O - https://raw.githubusercontent.com/mozilla-b2g/B2G/master/tools/51-android.rules | sudo tee >/dev/null /etc/udev/rules.d/51-android.rules; sudo udevadm control --reload-rules

The new rules take effect the next time a device is plugged in.

Requirements for an OS X build environment

To build on OS X, you need:

  • A modern Macintosh PC.
  • A virtual machine with Ubuntu 14.04 LTS installed.

Now that you have established your build machine, it's time to Configure your first build.

Document Tags and Contributors

 Contributors to this page: chrisdavidmills, rolfedh, AdFad666
 Last updated by: chrisdavidmills,