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