These instructions pertain to Windows. For Unix-like operating systems other than Mac OS X, read InstallationUnix. For Mac OS X instructions, read InstallationOSX. There are also simpler instructions available for OSes that use Debian-style packaging, like Debian and Ubuntu. For those operating systems, read InstallationDebian.

Install XULRunner

Read XULRunner for guidance in installing XULRunner.

Install Conkeror

You can obtain Conkeror either with git or by downloading a snapshot archive. Note that if you intend to make changes to the Conkeror source code, using Git will be enormously more convenient than using a snapshot, particularly if you may want to contribute your changes back to Conkeror. Git is fairly small, and is easy to install, even on Windows.

git

To use Conkeror from the git repository, first clone the repository, using the command:

git clone git://repo.or.cz/conkeror.git

Later on, when you want to update:

git fetch
git log HEAD..origin  #optional, shows you the changes
git merge origin

Last step

The last step is to make a shortcut to launch Conkeror. We currently recommend the XULRunner-stub method:

Xulrunner-Stub Method

1. Copy the file xulrunner-stub.exe from your XULRunner install directory into your Conkeror directory, and rename it conkeror.exe.

2. In a cmd.exe window, create a symlink xulrunner in your Conkeror directory that points to your XULRunner directory:

   • > cd \path\to\conkeror
     > mklink /D xulrunner \path\to\xulrunner

3. You can now create a shortcut to the conkeror.exe that you just made, on your desktop, in your start menu, or wherever.

Alternate Method (might not work)

There have been reports that this way does not work. If anybody knows why, or can tell us how these instructions need to be updated, please contact us.

Make a shortcut to xulrunner.exe in the Conkeror directory (by dragging and dropping while holding down Control+Shift).

Open the properties for the shortcut and set:

Target

"C:\Program Files\xulrunner\xulrunner.exe" "<Conkeror Install Dir>\application.ini"

Start in

<leave blank>

Rename the shortcut to Conkeror, and create other shortcuts as needed on your desktop and start menu.