Getting Set Up To Work On The Firefox Codebase

This page will help you get set up to build Firefox on your own machine.

Don’t hesitate to look at the Firefox Contributors Quick Reference to read a quick tutorial.

Thank you for contributing to Firefox

• Contributing to Mozilla projects
  • What skills do I need?

Setting Up Your Machine

For Firefox Desktop

• Building Firefox On Windows
• Building Firefox on Windows using WSL
• Building Firefox On macOS
• Building Firefox On Linux
• Building Firefox 32-bit On Linux 64-bit
• Common Build Errors

For Firefox Android

Firefox for Android

For Firefox iOS

Firefox for iOS

Getting Ready to Contribute

• How To Contribute Code To Firefox
  • Finding something to work on
    • Find a bug we’ve identified as a good fit for new contributors
    • Fix that one bug
  • Fixing your bug
  • Getting your code reviewed
    • Following up and responding
  • Getting code into Firefox
  • Do it all again
  • More information
• Building with Debug Symbols
  • Building Firefox with symbols
  • Breakpad symbol files
  • make package
• Configuring Build Options
  • Using a mozconfig configuration file
  • mozconfig contains two types of options
  • Building with an objdir
  • Parallel compilation
  • Choose a project
  • Selecting build options
    • sccache
    • buildcache
    • Optimization
    • Building as Beta or Release
    • Tests
    • Localization
    • Other Options
  • Example mozconfig Files
  • Building multiple projects from the same source tree
    • Using mozconfigwrapper
    • Changing build options per directory – the moz.build hook
• Editing toolkit/moz.configure
  • Prerequisites
  • moz.configure
    • The dependency graph