blob: 03aa349077a70eb958703c6d378c48fdfa1ee420 [file] [log] [blame] [edit]
## Gitblit as a Viewer
Gitblit is designed to be a complete Git server solution, however you may already have a Git serving solution such as ssh+gitolite or Gerrit. For these scenarios, you may configure Gitblit to be just a repository viewer.
### Lock-down your Viewer
Here is an example configuration that disables all administration, all Git serving features, and requires an authenticated user to view anything.
git.repositoriesFolder = ${baseFolder}/git
git.cacheRepositoryList = true
git.searchRepositoriesSubfolders = true
git.searchRecursionDepth = -1
git.searchExclusions =
git.daemonPort = 0
git.enableGitServlet = false
git.enableGarbageCollection = false
git.defaultAccessRestriction = VIEW
web.authenticateViewPages = true
web.allowAdministration = false
web.enableRpcServlet = false
web.enableRpcManagement = false
web.enableRpcAdministration = false
web.allowForking = false
### Tomcat or Reverse-Proxy Servers
If you are running Gitblit on a Tomcat-based container you will likely run into forward-slash character troubles.
To resolve this either set:
web.mountParameters = false
or
web.forwardSlashCharacter = !
### Advertised Repository Urls
You may also want to advertise repository urls for your other Git serving solution from Gitblit.
- *{0}* is the token for the repository name
- *{1}* is the token for the username
The username is only practical if you have setup the account names for your other git serving solution to match the Gitblit account.
web.otherUrls = ssh://localhost/git/{0} git://localhost:29418/git/{0} https://{1}@localhost/r/{0}