summaryrefslogtreecommitdiffstats
path: root/src/site/setup_proxy.mkd
diff options
context:
space:
mode:
authorJames Moger <james.moger@gitblit.com>2013-07-13 10:32:52 -0400
committerJames Moger <james.moger@gitblit.com>2013-07-13 10:32:52 -0400
commitcc04772888848c754880ed181fcf13c0a658e7ed (patch)
treeafcd366059547e69352a449cc7a6fac79cb25688 /src/site/setup_proxy.mkd
parentcb78b89ba770dc4edbd0f0a6ff70469cb8e0615c (diff)
downloadgitblit-cc04772888848c754880ed181fcf13c0a658e7ed.tar.gz
gitblit-cc04772888848c754880ed181fcf13c0a658e7ed.zip
Documentation
Diffstat (limited to 'src/site/setup_proxy.mkd')
-rw-r--r--src/site/setup_proxy.mkd24
1 files changed, 24 insertions, 0 deletions
diff --git a/src/site/setup_proxy.mkd b/src/site/setup_proxy.mkd
index 6e600f61..b169cefa 100644
--- a/src/site/setup_proxy.mkd
+++ b/src/site/setup_proxy.mkd
@@ -65,3 +65,27 @@ ProxyPreserveHost On
4. Set *web.mountParameters=false* in `gitblit.properties` or `web.xml` this will use parameterized URLs.
Alternatively, you can respecify *web.forwardSlashCharacter*.
+### Controlling Advertised Repository URLs
+
+In some reverse-proxy configurations you may be running Gitblit using an http interface with an https reverse-proxy proxy. This will lead to Gitblit generating incorrect repository urls.
+
+You can control the url that Gitblit generates by setting X-Forwarded headers in your proxy server.
+
+*X-Forwarded-Proto*://servername(:*X-Forwarded-Port*)(/*X-Forwarded-Context*)
+
+---X:MEDIAWIKI---
+{| class="table table-bordered"
+! Header
+! Description
+|-
+| X-Forwarded-Port
+| The port to use in generated repository http/https urls
+|-
+| X-Forwarded-Proto
+| The protocol/scheme to use in generated repository http/https urls
+|-
+| X-Forwarded-Context
+| The context to use in generated repository http/https urls
+|}
+---X:MEDIAWIKI---
+