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 [[http://repo.or.cz/w/conkeror.git?a=snapshot;h=master;sf=tgz|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`.

 1. 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
}}}

 1. 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.