To install on an older version of Windows, see `<installation_win_old.html>`_

Install Python 2.x.y (x = 6 or 7). Latest version is recommended. If you need another version, they can run side by side.

Remember the specific major and minor versions installed, because they will

be needed in the next step. In this case, it is "2.7".

Add Python BIN folder to the path. This can be done manually (editing

"PATH" environment variable) or by using Windows Support Tools that

Please substitute [your-python-path] with your Python installation

path. Typically this is ``C:\\Python27``.

Download pywin32 from:

http://sourceforge.net/projects/pywin32/files/

  http://sourceforge.net/projects/pywin32/files/pywin32/Build%20219/pywin32-219.win32-py2.7.exe/download

  (Win32)

pip is a package management system for Python. You will need it to install Kallithea and its dependencies.

  SETX PATH "%PATH%;[your-python-path]\Scripts" /M

Create a Kallithea folder structure.

  C:\Kallithea\Env

  C:\Kallithea\Repos

.. note::

   A python virtual environment will allow for isolation between the Python packages of your system and those used for Kallithea.

  virtualenv C:\Kallithea\Env

In order to install Kallithea, you need to be able to run "pip install kallithea". It will use pip to install the Kallithea Python package and its dependencies.

Some Python packages use managed code and need to be compiled.

          complete. Some warnings will appear. Don't worry, they are

          normal.

Mercurial being a python package, it was installed automatically when doing "pip install kallithea".

See http://git-scm.com/book/en/v2/Getting-Started-Installing-Git#Installing-on-Windows for instructions.

Steps taken from `<setup.html>`_

If you decided not to install git, you will get errors about it that you can ignore.

In the previous command prompt, being in the C:\\Kallithea\\Bin folder, type::

   These extra steps haven been marked as "64-bit".

   Tested on Windows Server 2008 R2 SP1, 9-feb-2013.

   If you run into any 64-bit related problems, please check these pages:

   - http://blog.victorjabur.com/2011/06/05/compiling-python-2-7-modules-on-windows-32-and-64-using-msvc-2008-express/

   - http://bugs.python.org/issue7511

Optional: You can also install MinGW, but VS2008 installation is easier.

(if not found or relocated, google for "visual studio 2008 express" for updated link. This link was taken from http://stackoverflow.com/questions/15318560/visual-c-2008-express-download-link-dead)

You can also download full ISO file for offline installation, just

choose "Visual C++ 2008 Express" when installing.

.. note::

Two different cases will pretty much cover the options for how it can be

installed.

  can be used in production. The Kallithea maintainers use the development

  branch in production. The advantage of installation from source and regularly

  updating it is that you take advantage of the most recent improvements. Using

.. _Certificate Checks:

Certificate Checks : optional

    `Enable LDAPS`_ is enabled.  Only DEMAND or HARD offer full SSL security

    while the other options are susceptible to man-in-the-middle attacks.  SSL

    certificates can be installed to /etc/openldap/cacerts so that the

    use = egg:PasteDeploy#prefix

    prefix = /<someprefix>

then change ``<someprefix>`` into your chosen prefix

    WSGIScriptAlias / /srv/kallithea/dispatch.wsgi

    WSGIPassAuthorization On

.. note::

   When running apache as root, please make sure it doesn't run Kallithea as

   root, for examply by adding: ``user=www-data group=www-data`` to the configuration.

   make sure you set ``instance_id = *`` in the configuration so each process

   gets it's own cache invalidation key.

Example WSGI dispatch script:

.. code-block:: python

<form action="https://www.paypal.com/cgi-bin/webscr" method="post" target="_top">

<input type="hidden" name="cmd" value="_s-xclick">

<input type="hidden" name="hosted_button_id" value="EYXFS3SQPHYUL">

<img alt="" border="0" src="https://www.paypalobjects.com/en_US/i/scr/pixel.gif" width="1" height="1">

</form>

    <div style="padding:5px">