| commit | author | age | ||
| 4ef60d | 1 | ## What is Gitblit? |
| 7328e2 | 2 | <div class="well" style="margin-left:5px;float:right;width:275px;padding: 10px 10px;"> |
| 4ef60d | 3 | <b>Current Release %VERSION% (%BUILDDATE%)</b> <a href="releases.html">changelog</a> |
| b774de | 4 | <div style="padding:5px;"><a style="width:150px;text-decoration:none;" class="btn success" href="http://code.google.com/p/gitblit/downloads/detail?name=%GO%">Download Gitblit GO</a></div> |
| JM | 5 | <div style="padding:5px;"><a style="width:150px;text-decoration:none;" class="btn danger" href="http://code.google.com/p/gitblit/downloads/detail?name=%WAR%">Download Gitblit WAR</a></div> |
| b4573f | 6 | <div style="padding:5px;"><a style="width:150px;text-decoration:none;" class="btn info" href="http://code.google.com/p/gitblit/downloads/detail?name=%EXPRESS%">Download Gitblit Express</a> <span class="label warning">BETA</span></div> |
| b774de | 7 | <div style="padding:5px;"><a style="width:150px;text-decoration:none;" class="btn primary" href="http://code.google.com/p/gitblit/downloads/detail?name=%MANAGER%">Download Gitblit Manager</a></div> |
| JM | 8 | <div style="text-align:center"> |
| 4ef60d | 9 | <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> |
| JM | 10 | <br/> |
| 11 | <a href="screenshots.html" title="Screenshots"><img style="margin-top:5px;border:1px solid #ccc;" src="thumbs/00.png" alt="Screenshots" /></a> | |
| 12 | </div> | |
| b774de | 13 | |
| 493ab0 | 14 | <div style="padding-top:5px;"> |
| JM | 15 | <table class="condensed-table"> |
| 16 | <tbody> | |
| 17 | <tr><th>License</th><td><a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, version 2.0</a></td></tr> | |
| 18 | <tr><th>Sources</th><td><a href="http://github.com/gitblit">GitHub</a> & <a href="http://code.google.com/p/gitblit/source/list">GoogleCode</a></td></tr> | |
| 19 | <tr><th>Issues</th><td><a href="http://code.google.com/p/gitblit/issues/list">GoogleCode</a></td></tr> | |
| 20 | <tr><th>Discussion</th><td><a href="http://groups.google.com/group/gitblit">Gitblit Group</a></td></tr> | |
| 21 | <tr><th>Google+</th><td><a href="https://plus.google.com/114464678392593421684">Gitblit+</a></td></tr> | |
| f35a98 | 22 | <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> |
| 6f46fa | 23 | <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.helpmegivetostjude.org/gitblit">St. Jude Children's Research Hospital</a>. |
| JM | 24 | <a href="http://www.helpmegivetostjude.org/gitblit" alt="St. Jude Children's Research Hospital"><img style="padding-top:10px;" src="stjude_150x150.gif"/></a></td></tr> |
| 493ab0 | 25 | </tbody> |
| b774de | 26 | </table> |
| 493ab0 | 27 | </div> |
| 4ef60d | 28 | </div> |
| 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 | |
| b774de | 33 | You can browse a live demo [here](http://demo-gitblit.rhcloud.com) hosted on [RedHat's OpenShift][rhcloud] cloud service. |
| JM | 34 | |
| 444101 | 35 | **NOTE:** |
| 942939 | 36 | The demo is a bit unstable due to a bug in JBossAS7/Tomcat when running in LOW_MEMORY mode which OpenShift mandates. RedHat engineers hope to have this issue resolved soon. |
| 444101 | 37 | |
| ed9953 | 38 | ### GO: Single-Stack Solution |
| 3b5289 | 39 | |
| ed9953 | 40 | *Gitblit GO* is an integrated, single-stack solution based on Jetty. |
| b774de | 41 | |
| ed9953 | 42 | 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 | 43 | |
| 44 | This is what you should download if you want to go from zero to Git in less than 5 mins. | |
| b774de | 45 | |
| 9be337 | 46 | All dependencies are bundled. |
| ed9953 | 47 | |
| JM | 48 | ### WAR: For Your Servlet Container |
| 493ab0 | 49 | *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 | 50 | |
| JM | 51 | All dependencies are bundled. |
| 52 | ||
| b4573f | 53 | ### Express: For the Cloud <span class="label warning" style="vertical-align: middle;">BETA</span> |
| b774de | 54 | *Gitblit Express* is a prepared distribution for [RedHat's OpenShift][rhcloud] cloud service. |
| JM | 55 | |
| ed9953 | 56 | All dependencies are bundled. |
| 85c2e6 | 57 | |
| ed9953 | 58 | ### You decide how to use Gitblit |
| 3b5289 | 59 | |
| ed9953 | 60 | Gitblit can be used as a dumb repository viewer with no administrative controls or user accounts. |
| JM | 61 | Gitblit can be used as a complete Git stack for cloning, pushing, and repository access control. |
| 62 | Gitblit can be used without any other Git tooling (including actual Git) or it can cooperate with your established tools. | |
| 2179fb | 63 | |
| b4573f | 64 | ### Easy Remote Management |
| 85c2e6 | 65 | |
| b4573f | 66 | Administrators can create and manage all repositories, user accounts, and teams from the *Web UI*. |
| JM | 67 | 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. |
| ed9953 | 68 | |
| 493ab0 | 69 | ### Integration with Your Infrastructure |
| ed9953 | 70 | |
| fa54be | 71 | - Groovy push hook scripts |
| ed9953 | 72 | - Pluggable user service mechanism for custom authentication, authorization, and user management |
| JM | 73 | - Rich RSS feeds |
| 74 | - JSON-based RPC mechanism | |
| 493ab0 | 75 | - [Java Client RSS/JSON API library](http://code.google.com/p/gitblit/downloads/detail?name=%API%) for custom integration |
| ed9953 | 76 | |
| JM | 77 | ### Backup Strategy |
| 78 | ||
| df162c | 79 | 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 | 80 | |
| ed9953 | 81 | ### Java Runtime Requirement |
| JM | 82 | |
| 83 | Gitblit requires a Java 6 Runtime Environment (JRE) or a Java 6 Development Kit (JDK). | |
| 84 | ||
| f90dc6 | 85 | [jgit]: http://eclipse.org/jgit "Eclipse JGit Site" |
| b774de | 86 | [git]: http://git-scm.com "Official Git Site" |
| JM | 87 | [rhcloud]: https://openshift.redhat.com/app "RedHat OpenShift" |
