Troubleshooting

Eclipse/Egit/Git complains that it "can't open upload pack"?

There are a few ways this can occur:

1. You are using https with a self-signed certificate and you did not configure http.sslVerify=false
   1. Window->Preferences->Team->Git->Configuration
   2. Click the New Entry button

   3. Key = *http.sslVerify*       
         Value = *false*

2. The repository is clone-restricted and you don't have access.
3. The repository is clone-restricted and your password changed.
4. A regression in Gitblit. :(

Why can't I access Gitblit from another machine?

Please check server.httpBindInterface and server.httpsBindInterface in gitblit.properties.

How do I run Gitblit on port 80 or 443 in Linux?

Linux requires root permissions to serve on ports < 1024.

Run the server as root (security concern) or change the ports you are serving to 8080 (http) and/or 8443 (https).

General Interest Questions

Gitblit? What kind of name is that?

It's a phonetic play on bitblt which is an image processing operation meaning bit-block transfer.

Why use Gitblit?

It's a small tool that allows you to easily manage shared repositories and doesn't require alot of setup or git kung-foo.

Do I need real Git?

No. Gitblit is based on JGit which is a pure Java implementation of the Git version control system.

Everything you need for Gitblit is either in the zip distribution file or automatically downloaded on execution.

Do I need a JDK or can I use a JRE?

Gitblit will run just fine with a JRE. Gitblit can optionally use keytool from the JDK to generate self-signed certificates, but normally Gitblit uses BouncyCastle for that need.

I want to deploy Gitblit into my own servlet container. Where is the WAR?

At this time there is no WAR build available.

Does Gitblit use a database to store its data?

No. Gitblit stores its repository configuration information within the .git/config file and its user information in users.properties or whatever filename is configured in gitblit.properties.

Can I manually edit users.properties, gitblit.properties, or .git/config?

Yes. You can manually manipulate all of them and (most) changes will be immediately available to Gitblit.
Exceptions to this are noted in gitblit.properties.

NOTE: Care must be taken to preserve the relationship between user roles and repository names.
Please see the setup page for details.

Can I restrict access to paths within a repository?

No. Access restrictions apply to the repository as a whole.

Gitblit's simple authentication and authorization mechanism can be used to facilitate one or more of the workflows outlined here. Should you require more fine-grained access controls you might consider using gitolite.

Why doesn't Gitblit support SSH?

Gitblit could integrate Apache Mina to provide SSH access. However, doing so violates Gitblit's first design principle: KISS.

SSH support requires creating, exchanging, and managing SSH keys. While this is possible, JGit's SmartHTTP implementation is a simpler and universal transport mechanism.

You might consider running Gerrit which does integrate Apache Mina and supports SSH or you might consider serving Git on Linux which would offer real SSH support and also allow use of many other compelling Git solutions.

What types of Search does Gitblit support?

Gitblit supports case-insensitive searches of commit message (default), author, and committer.

To search by author or committer use the following syntax in the search box:

author: james
committer: james

Alternatively, you could enable the search type dropdown list in your gitblit.properties file.

I see a disabled "blame" link. How do I enable it?

Currently blame is not implemented. Those links are placeholders to remind me where Gitweb offers blame.