Join MDN and developers like you at Mozilla's View Source conference, 12-14 September in Berlin, Germany. Learn more at


XULRunner is built using basically the same process as Firefox or other applications. Please read and follow the general Build Documentation for instructions on how to get sources and set up build prerequisites.

By default, XULRunner is built with JavaXPCOM support; the build system must be able to find an appropriate JDK on the system; see the instructions on Building JavaXPCOM for more details. If you do not want to build JavaXPCOM support, specify --disable-javaxpcom in your configuration.

On Mac, XULRunner requires Mac OS X 10.3 or higher and XCode 1.5 or higher to build properly. The runtime requirement is Mac OS X 10.2.

A basic minimal mozconfig which will build a release configuration of XULRunner is:

mk_add_options MOZ_CO_PROJECT=xulrunner
mk_add_options MOZ_OBJDIR=@topsrcdir@/obj-xulrunner

ac_add_options --enable-application=xulrunner
#Uncomment the following line if you don't want to build JavaXPCOM:
#ac_add_options --disable-javaxpcom

CVS tags and XULRunner versions

Older XULRunner releases where tagged in CVS with (for instance XULRUNNER_1_8_0_5_RELEASE ) up to version

The CVS repository does not have specific tags for XULRunner anymore. Instead a XULRunner build is a just special build made from the Firefox/Mozilla tree, using the same tag as a Firefox build. There is a convention where a certain XULRunner version maps to a certain tag in the CVS.

For instance XULRunner, the corresponding tag is CVS is : FIREFOX_2_0_0_3_RELEASE

To find out how those Firefox tags and XULRunner version maps, check out the file mozilla/config/milestone.txt .

You can also check the User Agent string in Firefox Help/About menu to get the mapping from a certain binary Firefox version to the corresponding XULRunner version. For instance, in Firefox you will get :

Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv: Gecko/20071025 Firefox/

Therefore the XULRunner version for this Firefox version is :

Fetching Sources from Mercurial

As with all other Mozilla products, one would fetch recent sources from Mercurial. For example, to build XULRunner with the top of the tree:

hg clone src
cd src
echo ". \$topsrcdir/xulrunner/config/mozconfig" > .mozconfig
make -f build

Interwiki Language Links

Document Tags and Contributors

 Last updated by: teoli,