Contents
If you are installing Conkeror through your OS package manager, these instructions probably do not apply to you, because installing Conkeror that way will install an appropriate version of XULRunner by dependency.
1. What Version?
Conkeror 1.0 depends on XULRunner 1.9.1 or higher.
Conkeror 0.9.x depends on XULRunner 1.9.0 or higher.
The best is to use a stable released version. Unreleased development versions may have breaking changes for which Conkeror has not yet been updated.
2. Install XULRunner
2.1. From your OS Package Manager
Many operating systems provide XULRunner packages of an appropriate version to run Conkeror. If available, this is the easiest way to install and upgrade XULRunner. Refer to the documentation for your OS for how to locate and install such a package.
2.2. Manual
Manual installation of XULRunner is a very simple process, because binary builds are available from Mozilla for major platforms.
- Download an archive appropriate for your operating system and architecture. For each version of XULRunner in the XULRunner Releases archive, there are subdirectories 'runtimes', 'sdk', and 'source'. The ones in 'runtimes' are the ones to use. (The sdk version can also be used, but it is not required, and much larger.)
- For OS X, the archive contains an installer. Run it and follow the instructions. For other OSes, just unpack the archive somewhere. It does not need to be installed to system directories.
2.3. For XULRunner 2 and earlier
For XULRunner 2 and earlier, on platforms other than OS X, GRE registration must be performed. It can be done either for an individual user account or for the whole system. With the user version, it puts an entry in ~/.gre.d. With the system version, it puts an entry in /etc/gre.d. Enter the new XULRunner directory and do one of the following:
./xulrunner --register-user
or, as root/administrator:
./xulrunner --register-global