.. _authentication:

Authentication setup

====================

Users can be authenticated in different ways. By default, Kallithea

uses its internal user database. Alternative authentication

methods include LDAP, PAM, Crowd, and container-based authentication.

.. _ldap-setup:

LDAP Authentication

-------------------

- Kallithea can also be installed from ready-made packages using a package manager.

  The official released versions are available on PyPI_ and can be downloaded and

  installed with all dependencies using ``pip install kallithea``.

  With this method, Kallithea is installed in the Python environment as any

  other package, usually as a ``.../site-packages/Kallithea-X-py2.7.egg/``

  directory with Python files and everything else that is needed.

  (``pip install kallithea`` from a source tree will do pretty much the same

  but build the Kallithea package itself locally instead of downloading it.)

The tool npm_ is used to download external dependencies and orchestrate the

processing. The ``npm`` binary must thus be available.

Web server

----------

Kallithea is (primarily) a WSGI_ application that must be run from a web

server that serves WSGI applications over HTTP.

Kallithea itself is not serving HTTP (or HTTPS); that is the web server's

responsibility. Kallithea does however need to know its own user facing URL