James Moger
2014-05-12 edeab95cac16e5f17cfcd75a9969d8708bf360ab
commit | author | age
7328e2 1 <div class="well" style="margin-left:5px;float:right;width:275px;padding: 10px 10px;">
f6b200 2 <div style="text-align:center">
JM 3 <b>Current Release ${project.releaseVersion} (${project.releaseDate})</b><br/><a href="releasenotes.html">release notes</a>
4 <div style="padding:5px;"><a style="width:175px;text-decoration:none;" class="btn btn-success" href="%GCURL%gitblit-${project.releaseVersion}.zip">Download Gitblit GO (Windows)</a></div>
5 <div style="padding:5px;"><a style="width:175px;text-decoration:none;" class="btn btn-success" href="%GCURL%gitblit-${project.releaseVersion}.tar.gz">Download Gitblit GO (Linux/OSX)</a></div>
6 <div style="padding:5px;"><a style="width:175px;text-decoration:none;" class="btn btn-danger" href="%GCURL%gitblit-${project.releaseVersion}.war">Download Gitblit WAR</a></div>
7 <div style="padding:5px;"><a style="width:175px;text-decoration:none;" class="btn btn-info" href="%GCURL%express-${project.releaseVersion}.zip">Download Gitblit Express</a></div>
8 <div style="padding:5px;"><a style="width:175px;text-decoration:none;" class="btn btn-primary" href="%GCURL%manager-${project.releaseVersion}.zip">Download Gitblit Manager</a></div>
b65e6d 9         <a href='https://bintray.com/gitblit/releases/gitblit/view?source=watch' alt='Get automatic notifications about new "stable" versions'><img src='https://www.bintray.com/docs/images/bintray_badge_color.png'></a>
4ef60d 10     </div>
b774de 11
493ab0 12     <div style="padding-top:5px;">
3cc6e2 13     <table class="table condensed-table">
493ab0 14         <tbody>
f6b200 15         <tr><th>License</th><td><a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License 2.0</a></td></tr>
JM 16         <tr><th>Sources</th><td><a href="${project.scmUrl}">GitHub</a> &amp; <a href="http://code.google.com/p/gitblit/source/list">GoogleCode</a></td></tr>        
17         <tr><th>Issues</th><td><a href="${project.issuesUrl}">GoogleCode</a></td></tr>
18         <tr><th>Discussion</th><td><a href="${project.forumUrl}">Gitblit Group</a></td></tr>
19         <tr><th>Google+</th><td><a href="${project.socialNetworkUrl}">Gitblit+</a></td></tr>
f35a98 20         <tr><th>Ohloh</th><td><a target="_top" href="http://www.ohloh.net/p/gitblit"><img border="0" width="100" height="16" src="http://www.ohloh.net/p/gitblit/widgets/project_thin_badge.gif" alt="Ohloh project report for Gitblit" /></a></td></tr>
f6b200 21         <tr><th>Donations</th><td>If you enjoy Gitblit and want to support its development, please consider making a donation to <a href="http://www.stjude.org">St. Jude Children's Research Hospital</a>.
JM 22         <a href="http://www.stjude.org" alt="St. Jude Children's Research Hospital"><img style="padding-top:10px;" src="stjude_150x150.gif"/></a></td></tr>
493ab0 23         </tbody>
b774de 24         </table>
493ab0 25     </div>
4ef60d 26 </div>
52b26f 27
JM 28 ## What is Gitblit?
85c2e6 29
ed9953 30 Gitblit is an open-source, pure Java stack for managing, viewing, and serving [Git][git] repositories.  
JM 31 It's designed primarily as a tool for small workgroups who want to host centralized repositories.
85c2e6 32
ed9953 33 ### GO: Single-Stack Solution
3b5289 34
ed9953 35 *Gitblit GO* is an integrated, single-stack solution based on Jetty.
b774de 36
ed9953 37 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.
JM 38
39 This is what you should download if you want to go from zero to Git in less than 5 mins.
b774de 40
ed9953 41 ### WAR: For Your Servlet Container
493ab0 42 *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.
b774de 43
1ab5b3 44 ### Express: For the Cloud
b774de 45 *Gitblit Express* is a prepared distribution for [RedHat's OpenShift][rhcloud] cloud service.
85c2e6 46
ed9953 47 ### You decide how to use Gitblit
3b5289 48
ed9953 49 Gitblit can be used as a dumb repository viewer with no administrative controls or user accounts.  
JM 50 Gitblit can be used as a complete Git stack for cloning, pushing, and repository access control.  
51 Gitblit can be used without any other Git tooling (including actual Git) or it can cooperate with your established tools.
2179fb 52
b4573f 53 ### Easy Remote Management
85c2e6 54
b4573f 55 Administrators can create and manage all repositories, user accounts, and teams from the *Web UI*.  
JM 56 Administrators can create and manage all repositories, user accounts, and teams from the *JSON RPC interface* using the [Gitblit Manager](http://code.google.com/p/gitblit/downloads/detail?name=%MANAGER%) or your own custom tooling. 
69eeaa 57 Administrators can create and manage all repositories, user accounts, and teams from the *command-line* using the [Powertools plugin](https://github.com/gitblit/gitblit-powertools-plugin).
ed9953 58
493ab0 59 ### Integration with Your Infrastructure
ed9953 60
69eeaa 61 - Extendable by plugins
fa54be 62 - Groovy push hook scripts
6e15cb 63 - Pluggable user service mechanism
JM 64     - LDAP authentication with optional LDAP-controlled Team memberships
2659e7 65     - Redmine authentication
JM 66     - SalesForce.com authentication
67     - Windows authentication
68     - PAM authentication
6e15cb 69     - Custom authentication, authorization, and user management
ed9953 70 - Rich RSS feeds
JM 71 - JSON-based RPC mechanism
493ab0 72 - [Java Client RSS/JSON API library](http://code.google.com/p/gitblit/downloads/detail?name=%API%) for custom integration
ed9953 73
JM 74 ### Backup Strategy
75
df162c 76 Gitblit includes a backup mechanism (*federation*) which can be used to backup repositories and, optionally, user accounts, team definitions, server settings, & Groovy push hook scripts 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.
9b72a2 77
ed9953 78 ### Java Runtime Requirement
JM 79
e22185 80 Gitblit requires a Java 7 Runtime Environment (JRE) or a Java 7 Development Kit (JDK).
ed9953 81
f90dc6 82 [jgit]: http://eclipse.org/jgit "Eclipse JGit Site"
b774de 83 [git]: http://git-scm.com "Official Git Site"
6e15cb 84 [rhcloud]: https://openshift.redhat.com/app "RedHat OpenShift"