# HG changeset patch
# User Thomas De Schampheleire <thomas.de_schampheleire@nokia.com>
# Date 2018-07-30 19:19:33
# Node ID 52f823b9261483135e3b55f6b14634eee39dbf56
# Parent  2bb5e9ee49fef539e93ff018bbda7bc9d9eec96e

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

diff --git a/docs/administrator_guide/vcs_setup.rst b/docs/administrator_guide/vcs_setup.rst
--- a/docs/administrator_guide/vcs_setup.rst
+++ b/docs/administrator_guide/vcs_setup.rst
@@ -46,6 +46,15 @@ Also make sure to comment out the follow
     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