System Requirements

  • 2G RAM with lots of available swap space. Additional RAM will significantly decrease build time.
  • For debug builds: at least 8 GB free disk space
  • For optimized builds: at least 1 GB free disk space (6 GB recommended)
  • As of early 2015, it is no longer possible to compile Firefox from source on most 32-bit systems; a 64-bit OS is required. On Linux you can determine this by typing "uname -a" in a terminal.
  • GCC 4.7 or later is required; the Firefox codebase relies on some C++ features that are not supported in GCC 4.6 or earlier.
  • autoconf 2.13. Most Linux distros now install a later version of autoconf, which the build system cannot use, reporting the error "*** Couldn't find autoconf 2.13.  Stop." However a separate autoconf213 package is usually available.
  • Note: Building in Linux on top of a non-native file system - for example, on a mounted NTFS partition - is explicitly not supported. While a build environment like this may succeed it may also fail while claiming to have succeeded, which can be quite difficult to diagnose and fix.

One-Line Bootstrapping

You can attempt running our system bootstrapping script to install all system dependencies:

wget -q https://hg.mozilla.org/mozilla-central/raw-file/default/python/mozboot/bin/bootstrap.py && python bootstrap.py

Note: piping bootstrap.py to stdin of a python process will cause interactive prompts in the bootstrap script to fail, causing the bootstrap process to fail. You must run Python against a local file.

If the above command fails, the reason is often because some Linux distributions ship with an outdated list of root certificates. In this case, you should upgrade your Linux distribution or use your browser to download the file. That ensures that you will get it from the right source.

If this works, great! If not, see the appropriate section below. If you encounter an error, consider filing a bug saying that the bootstrapper didn't work. Please include output and relevant operating system details.

If you have already checked out the source code via Mercurial or Git you can also use mach with the bootstrap command:

./mach bootstrap

Common Bootstrapper Failures

wget: command not found

You may not have wget (or curl) installed. In that case, download bootstrap.py using your browser and then run with this command:

python bootstrap.py

More Info

The above bootstrap script supports popular Linux distributions. If it doesn't work for you, see Linux build prerequisites for more. If you run into other problems or our documentation isn't clear, please contact Mike Hoye directly.

Document Tags and Contributors

Last updated by: globau,