kallithea Files · docs/usage/git

Files @ cdf10b3df899

Branch filter:

Location: kallithea/docs/usage/git_support.rst

cdf10b3df899 1.2 KiB text/prs.fallenstein.rst Show Annotation Show as Raw Download as Raw

Jonathan Sternberg

Allow RhodeCode maintainers to specify a custom bug tracker.

This allows people who maintain large RhodeCode installations to setup their
own bug tracker and respond to requests against their specific installation.
The maintainer is then free to forward problems with RhodeCode to the
canonical issue tracker on bitbucket.

If the config option "bugtracker" is present, its value will be used with the
"Report a bug" button. If left blank, this disables the button. If no value is
present, then the default is used. This is so that the new config option
doesn't break installations of RhodeCode upgrading to a newer version and to
allow easier installation for the common use case.

.. _git_support:

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


Git support in RhodeCode 1.3 was enabled by default. You need to have a git
client installed on the machine to make git fully work.

Although There is one limitation on git usage.

- large pushes requires a http server with chunked encoding support.

if you plan to use git you need to run RhodeCode with some
http server that supports chunked encoding which git http protocol uses,
i recommend using waitress_ or gunicorn_ (linux only) for `paste` wsgi app
replacement. Starting from version 1.4 waitress_ is the default wsgi server
used in RhodeCode.

To use, simply change change the following in the .ini file::

    use = egg:Paste#http

to::

    use = egg:waitress#main

or::

    use = egg:gunicorn#main


And comment out bellow options::

    threadpool_workers =
    threadpool_max_requests =
    use_threadpool =


You can simply run `paster serve` as usual.


You can always disable git/hg support by editing a
file **rhodecode/__init__.py** and commenting out backends

.. code-block:: python

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

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