| | |
| | | ## Overview
|
| | | <a href="screenshots.html" title="Screenshots"><img class="overview" src="thumbs/00.png" alt="Screenshots" /></a>
|
| | | ## What is Gitblit?
|
| | | <div class="well" style="float:right;padding: 14px 14px;">
|
| | | <b>Current Release %VERSION% (%BUILDDATE%)</b> <a href="releases.html">changelog</a>
|
| | | <div style="padding:5px;"><a style="text-decoration:none;" class="btn success" href="http://code.google.com/p/gitblit/downloads/detail?name=%GO%">Download Gitblit GO</a></div>
|
| | | <div style="padding:5px;"><a style="text-decoration:none;" class="btn danger" href="http://code.google.com/p/gitblit/downloads/detail?name=%WAR%">Download Gitblit WAR</a></div>
|
| | | <div style="padding:5px;"><a style="text-decoration:none;" class="btn primary" href="http://code.google.com/p/gitblit/downloads/detail?name=%MANAGER%">Download Gitblit Manager</a></div>
|
| | | <div style="text-align:center;">
|
| | | <a href="http://code.google.com/p/gitblit/downloads/detail?name=%API%">Gitblit API</a> | <a href="http://code.google.com/p/gitblit/downloads/detail?name=%FEDCLIENT%">Gitblit Federation Client</a>
|
| | | <br/>
|
| | | <a href="screenshots.html" title="Screenshots"><img style="margin-top:5px;border:1px solid #ccc;" src="thumbs/00.png" alt="Screenshots" /></a>
|
| | | </div>
|
| | | </div>
|
| | |
|
| | | Gitblit is an open-source, pure Java stack for managing, viewing, and serving [Git][git] repositories.<br/>
|
| | | Its designed primarily as a tool for small workgroups who want to host centralized repositories.
|
| | | Gitblit is an open-source, pure Java stack for managing, viewing, and serving [Git][git] repositories. |
| | | It's designed primarily as a tool for small workgroups who want to host centralized repositories.
|
| | |
|
| | | Gitblit is available in two variations:
|
| | | <ul class='noBullets'>
|
| | | <li>*Gitblit GO* - a complete & integrated pure Java stack<p>
|
| | | This is what you should download if you want to go from zero to Git in less than 5 mins.<br/>
|
| | | Gitblit GO is like a mashup of Apache httpd, [Git][git], and Gitweb with simplified configuration and maintenance.<br/>
|
| | | All dependencies are downloaded on first execution.<p>
|
| | | <li>*Gitblit WAR* - a traditional WAR distribution<p>
|
| | | This is what you should download if you want to deploy Gitblit into your own servlet container (e.g. Tomcat, Jetty, etc).<br/>
|
| | | All dependencies are bundled.
|
| | | </ul>
|
| | | ### GO: Single-Stack Solution
|
| | |
|
| | | ### Tools
|
| | | <ul class='noBullets'>
|
| | | <li>*Gitblit RPC Client* - a Java Swing tool to clone repositories and remotely administer a Gitblit server
|
| | | <li>*Gitblit Federation Client* - a command line tool to clone/pull groups of repositories and optionally users and settings
|
| | | </ul>
|
| | | *Gitblit GO* is an integrated, single-stack solution based on Jetty.
|
| | | |
| | | You do not need Apache httpd, Perl, Git, or Gitweb. Should you want to use some or all of those, you still can; Gitblit plays nice with the other kids on the block.
|
| | |
|
| | | This is what you should download if you want to go from zero to Git in less than 5 mins.
|
| | | |
| | | All dependencies are downloaded on first execution.
|
| | |
|
| | | ### WAR: For Your Servlet Container
|
| | | *Gitblit WAR* is what you should download if you already have a servlet container available that you wish to use. |
| | | Jetty 6/7/8 and Tomcat 6/7 are known to work. Generally, any Servlet 2.5 or Servlet 3.0 container should work.
|
| | | |
| | | All dependencies are bundled.
|
| | |
|
| | | ### You decide how to use Gitblit
|
| | |
|
| | | Gitblit can be used as a dumb repository viewer with no administrative controls or user accounts. |
| | | Gitblit can be used as a complete Git stack for cloning, pushing, and repository access control. |
| | | Gitblit can be used without any other Git tooling (including actual Git) or it can cooperate with your established tools.
|
| | |
|
| | | ### Easy Web Management
|
| | |
|
| | | Administrators can create and manage all repositories & user accounts from the *Web UI*. |
| | | Administrators can create and manage all repositories & user accounts from the *JSON RPC interface* using the [Gitblit Manager](http://code.google.com/p/gitblit/downloads/detail?name=%MANAGER%) or your own custom tooling. |
| | |
|
| | | ### Integration and Mining
|
| | |
|
| | | - Pluggable user service mechanism for custom authentication, authorization, and user management
|
| | | - Rich RSS feeds
|
| | | - JSON-based RPC mechanism
|
| | | - [Java Client API library](http://code.google.com/p/gitblit/downloads/detail?name=%API%) for custom integration
|
| | |
|
| | | ### Backup Strategy
|
| | |
|
| | | Gitblit includes a backup mechanism (*federation*) which can be used to backup repositories and, optionally, user accounts & server settings from your Gitblit instance to another Gitblit instance or to a [Gitblit Federation Client](http://code.google.com/p/gitblit/downloads/detail?name=%FEDCLIENT%). Similarly, you can use the federation mechanism to aggregate individual workspace Gitblit instances to a common, centralized server.
|
| | |
|
| | | ### Project Management and Community
|
| | |
|
| | | issues, binaries, and sources @ [Google Code][googlecode] |
| | | sources @ [Github][gitbltsrc] |
| | | group discussion @ the [Gitblit Discussion Group](http://groups.google.com/group/gitblit) |
| | | follow Gitblit @ [google+](https://plus.google.com/114464678392593421684)
|
| | |
|
| | | ### Java Runtime Requirement
|
| | |
|
| | | Gitblit requires a Java 6 Runtime Environment (JRE) or a Java 6 Development Kit (JDK).
|
| | |
|
| | | ### Current Release
|
| | |
|
| | | **%VERSION%** ([go](http://code.google.com/p/gitblit/downloads/detail?name=%GO%)|[war](http://code.google.com/p/gitblit/downloads/detail?name=%WAR%)|[fedclient](http://code.google.com/p/gitblit/downloads/detail?name=%FEDCLIENT%)|[rpcclient](http://code.google.com/p/gitblit/downloads/detail?name=%RPCCLIENT%)) based on [%JGIT%][jgit] *released %BUILDDATE%*
|
| | |
|
| | | - improved: overhauled web ui with Twitter's Bootstrap CSS toolkit
|
| | | <br/>**New:** *web.loginMessage = gitblit*
|
| | | - added: authenticated JSON RPC mechanism |
| | | <br/>**New:** *web.enableRpcServlet = true*
|
| | | <br/>**New:** *web.enableRpcAdministration = false*
|
| | | - added: reusable JSON RPC client class
|
| | | - added: Swing RPC Client application for cloning and administration of repositories, users, and federation proposals.
|
| | | - fixed/broke: federation protocol. dates are now serialized to the [iso8601](http://en.wikipedia.org/wiki/ISO_8601) standard. This breaks 0.6.0 federation clients/servers.
|
| | | - fixed: Gitblit now runs on Servlet 3.0 webservers (e.g. Tomcat 7, Jetty 8)
|
| | | - fixed: Set the RSS content type for Firefox 4 (issue 22)
|
| | | - fixed: Null pointer exception if did not set federation strategy (issue 20)
|
| | | - fixed: Gitblit GO allows SSL renegotiation if running on Java 1.6.0_22 or later
|
| | | - added: IUserService.setup(IStoredSettings) for custom user service implementations
|
| | |
|
| | | issues, binaries, and sources @ [Google Code][googlecode]<br/>
|
| | | sources @ [Github][gitbltsrc]
|
| | |
|
| | | ### License
|
| | | Gitblit is distributed under the terms of the [Apache Software Foundation license, version 2.0][apachelicense]
|