NOTE: Do not make substantive changes to this document without consulting Benjamin Smedberg <firstname.lastname@example.org> or one of the build-config peers.
NOTE: Do not begin a build without configuring your build options first!
You must use GNU make to check out and build Mozilla. No other "make" program is acceptable. On windows and mac, use "make" to run GNU make; on most unixes, use "gmake".
gmake -f client.mk build
If you wish to manually configure and build, cd to your objdir, run configure, and then run gmake. Configure will still pick up options specified in a mozconfig file.
Running Your New Build
On non-macintosh build system, the finished build can be found in objdir/dist/bin. On *nix platforms, you should run the file "mozilla" or "firefox", not the binary "mozilla-bin" or "firefox-bin".
On macintosh, the build system produces an application bundle at objdir/dist/AppName.app
Note: This build directory contains symlinks into the build tree. You must run the installation/packaging step to produce a standalone build which can be shared or moved.
Installing Your Build
On *nix platforms, you can install your build to the system by running gmake install. However, it is often better to follow the steps below to make a tarball, then unpack the tarball.
For most apps, prepare a tarball/zip of your build by making in an app-specific directory:
- Firefox: gmake -C objdir/browser/installer
- Thunderbird: gmake -C objdir/mail/installer
- SeaMonkey: gmake -C objdir/xpinstall/packager
To make a windows installer, make the "installer" target in the above directory:
- Firefox: gmake -C objdir/browser/installer installer
- Thunderbird: gmake -C objdir/mail/installer installer
- SeaMonkey: gmake -C objdir/xpinstall/packager installer
NOTE: To make the highly compressed installer used by Firefox and Thunderbird, you must install a few additional programs:
Both of these utilities must exist in the PATH. In addition, export MOZ_INSTALLER_USE_7ZIP.