##// END OF EJS Templates
docs: vcs_setup: add note about Git HTTP POST buffer...
Thomas De Schampheleire -
r7261:52f823b9 default
parent child Browse files
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