Show More
@@ -1,52 +1,61 b'' | |||
|
1 | 1 | .. _vcs_setup: |
|
2 | 2 | |
|
3 | 3 | ============================= |
|
4 | 4 | Version control systems setup |
|
5 | 5 | ============================= |
|
6 | 6 | |
|
7 | 7 | Kallithea supports Git and Mercurial repositories out-of-the-box. |
|
8 | 8 | For Git, you do need the ``git`` command line client installed on the server. |
|
9 | 9 | |
|
10 | 10 | You can always disable Git or Mercurial support by editing the |
|
11 | 11 | file ``kallithea/__init__.py`` and commenting out the backend. For example, to |
|
12 | 12 | disable Git but keep Mercurial enabled: |
|
13 | 13 | |
|
14 | 14 | .. code-block:: python |
|
15 | 15 | |
|
16 | 16 | BACKENDS = { |
|
17 | 17 | 'hg': 'Mercurial repository', |
|
18 | 18 | #'git': 'Git repository', |
|
19 | 19 | } |
|
20 | 20 | |
|
21 | 21 | |
|
22 | 22 | Git-specific setup |
|
23 | 23 | ------------------ |
|
24 | 24 | |
|
25 | 25 | |
|
26 | 26 | Web server with chunked encoding |
|
27 | 27 | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ |
|
28 | 28 | |
|
29 | 29 | Large Git pushes require an HTTP server with support for |
|
30 | 30 | chunked encoding for POST. The Python web servers waitress_ and |
|
31 | 31 | gunicorn_ (Linux only) can be used. By default, Kallithea uses |
|
32 | 32 | waitress_ for `gearbox serve` instead of the built-in `paste` WSGI |
|
33 | 33 | server. |
|
34 | 34 | |
|
35 | 35 | The web server used by gearbox is controlled in the .ini file:: |
|
36 | 36 | |
|
37 | 37 | use = egg:waitress#main |
|
38 | 38 | |
|
39 | 39 | or:: |
|
40 | 40 | |
|
41 | 41 | use = egg:gunicorn#main |
|
42 | 42 | |
|
43 | 43 | Also make sure to comment out the following options:: |
|
44 | 44 | |
|
45 | 45 | threadpool_workers = |
|
46 | 46 | threadpool_max_requests = |
|
47 | 47 | use_threadpool = |
|
48 | 48 | |
|
49 | Increasing Git HTTP POST buffer size | |
|
50 | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | |
|
51 | ||
|
52 | If Git pushes fail with HTTP error code 411 (Length Required), you may need to | |
|
53 | increase the Git HTTP POST buffer. Run the following command as the user that | |
|
54 | runs Kallithea to set a global Git variable to this effect:: | |
|
55 | ||
|
56 | git config --global http.postBuffer 524288000 | |
|
57 | ||
|
49 | 58 | |
|
50 | 59 | .. _waitress: http://pypi.python.org/pypi/waitress |
|
51 | 60 | .. _gunicorn: http://pypi.python.org/pypi/gunicorn |
|
52 | 61 | .. _subrepositories: http://mercurial.aragost.com/kick-start/en/subrepositories/ |
General Comments 0
You need to be logged in to leave comments.
Login now