##// 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 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