src/site/setup_viewer.mkd

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