kallithea Files · docs/usage/git

Files @ 03bbd33bc084

Branch filter:

Location: kallithea/docs/usage/git_support.rst

03bbd33bc084 1.1 KiB text/prs.fallenstein.rst Show Annotation Show as Raw Download as Raw

Mads Kiilerich

docs: rework stuff

The existing docs were far from how we wanted it to be. There was so much to do
and it is not feasible to do that cleanup it in clean patches.

Instead, I took a sweep through the docs and changed what I thought could
benefit from a change: structure, examples, advices, language, markup, content,
etc.

.. _git_support:

===========
GIT support
===========


Kallithea Git support is enabled by default. You just need a git
command line client installed on the server to make Git work fully.

Web server with chunked encoding
--------------------------------

Large Git pushes do however require a http server with support for chunked encoding for POST.

The Python web servers waitress_ and gunicorn_ (linux only) can be used.
By default, Kallithea uses waitress_ for `paster serve` instead of the built-in `paste` WSGI server. 

The default paste server is controlled in the .ini file::

    use = egg:waitress#main

or::

    use = egg:gunicorn#main


Also make sure to comment out the following options::

    threadpool_workers =
    threadpool_max_requests =
    use_threadpool =


Disabling Git
-------------

You can always disable git/hg support by editing a
file **kallithea/__init__.py** and commenting out the backend.

.. code-block:: python

   BACKENDS = {
       'hg': 'Mercurial repository',
       #'git': 'Git repository',
   }

.. _waitress: http://pypi.python.org/pypi/waitress
.. _gunicorn: http://pypi.python.org/pypi/gunicorn