Changeset - 52f823b92614
[Not reviewed]
default
0 1 0
Thomas De Schampheleire - 7 years ago 2018-07-30 21:19:33
thomas.de_schampheleire@nokia.com
docs: vcs_setup: add note about Git HTTP POST buffer

As suggested by https://bitbucket.org/conservancy/kallithea/issues/229/bad-file-descriptor#comment-30073565
1 file changed with 9 insertions and 0 deletions:
0 comments (0 inline, 0 general)
docs/administrator_guide/vcs_setup.rst
Show inline comments
 
@@ -25,28 +25,37 @@ Git-specific setup
 

	
 
Web server with chunked encoding
 
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 

	
 
Large Git pushes require an HTTP server with support for
 
chunked encoding for POST. The Python web servers waitress_ and
 
gunicorn_ (Linux only) can be used. By default, Kallithea uses
 
waitress_ for `gearbox serve` instead of the built-in `paste` WSGI
 
server.
 

	
 
The web server used by gearbox is controlled in the .ini file::
 

	
 
    use = egg:waitress#main
 

	
 
or::
 

	
 
    use = egg:gunicorn#main
 

	
 
Also make sure to comment out the following options::
 

	
 
    threadpool_workers =
 
    threadpool_max_requests =
 
    use_threadpool =
 

	
 
Increasing Git HTTP POST buffer size
 
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 

	
 
If Git pushes fail with HTTP error code 411 (Length Required), you may need to
 
increase the Git HTTP POST buffer. Run the following command as the user that
 
runs Kallithea to set a global Git variable to this effect::
 

	
 
    git config --global http.postBuffer 524288000
 

	
 

	
 
.. _waitress: http://pypi.python.org/pypi/waitress
 
.. _gunicorn: http://pypi.python.org/pypi/gunicorn
 
.. _subrepositories: http://mercurial.aragost.com/kick-start/en/subrepositories/
0 comments (0 inline, 0 general)