James Moger
2014-10-27 3f37176a1489a553422f17a05a79374e7815f025
commit | author | age
7328e2 1 <div class="well" style="margin-left:5px;float:right;width:275px;padding: 10px 10px;">
a5086d 2 <script>
JM 3    (function(d, s, id) {
4        var js, fjs = d.getElementsByTagName(s)[0];
5        if (d.getElementById(id)) return;
6        js = d.createElement(s); js.id = id;
7        js.async = true;
8        js.src = "//go.jelastic.com/widgets.js";
9        fjs.parentNode.insertBefore(js, fjs);
10    }(document, 'script', 'jelastic-jssdk'));
11 </script>
f6b200 12 <div style="text-align:center">
JM 13 <b>Current Release ${project.releaseVersion} (${project.releaseDate})</b><br/><a href="releasenotes.html">release notes</a>
14 <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>
15 <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>
16 <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>
17 <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 18         <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 19     </div>
a5086d 20 <div data-manifest="http://1c57d83a4c5f3a21ec25c050d4c5e37b.app.jelastic.com/xssu/cross/download/RDYYHABkAFJbUVlMMVU7RUtDARgATExFCEBuGS4jdQJKRUsEDwIBQmNTTEBI" data-width="280" data-theme="flat-blue" data-text="Get it hosted now!" data-tx-empty="Type your email and click the button" data-tx-invalid-email="Invalid email, please check the spelling" data-tx-error="An error has occurred, please try again later" data-tx-success="Check your email" class="je-app" ></div>
493ab0 21     <div style="padding-top:5px;">
3cc6e2 22     <table class="table condensed-table">
493ab0 23         <tbody>
f6b200 24         <tr><th>License</th><td><a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License 2.0</a></td></tr>
3f3717 25         <tr><th>Sources</th><td><a href="${project.scmUrl}">GitHub</a></td></tr>        
f6b200 26         <tr><th>Issues</th><td><a href="${project.issuesUrl}">GoogleCode</a></td></tr>
JM 27         <tr><th>Discussion</th><td><a href="${project.forumUrl}">Gitblit Group</a></td></tr>
28         <tr><th>Google+</th><td><a href="${project.socialNetworkUrl}">Gitblit+</a></td></tr>
f35a98 29         <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 30         <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 31         <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 32         </tbody>
b774de 33         </table>
493ab0 34     </div>
4ef60d 35 </div>
52b26f 36
JM 37 ## What is Gitblit?
85c2e6 38
ed9953 39 Gitblit is an open-source, pure Java stack for managing, viewing, and serving [Git][git] repositories.  
JM 40 It's designed primarily as a tool for small workgroups who want to host centralized repositories.
85c2e6 41
ed9953 42 ### GO: Single-Stack Solution
3b5289 43
ed9953 44 *Gitblit GO* is an integrated, single-stack solution based on Jetty.
b774de 45
ed9953 46 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 47
48 This is what you should download if you want to go from zero to Git in less than 5 mins.
b774de 49
ed9953 50 ### WAR: For Your Servlet Container
493ab0 51 *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.
85c2e6 52
ed9953 53 ### You decide how to use Gitblit
3b5289 54
ed9953 55 Gitblit can be used as a dumb repository viewer with no administrative controls or user accounts.  
JM 56 Gitblit can be used as a complete Git stack for cloning, pushing, and repository access control.  
57 Gitblit can be used without any other Git tooling (including actual Git) or it can cooperate with your established tools.
2179fb 58
a5086d 59 ### All Transports
JM 60
61 The SSH, HTTP, & GIT protocols are supported and ready-to-go out of the box.
62
63 ### Issue tracking with branch-based pull requests
64
65 Gitblit blends elements of GitHub, BitBucket, and Gerrit to provide a streamlined collaboration workflow based on branches within the primary repository.
66
b4573f 67 ### Easy Remote Management
85c2e6 68
b4573f 69 Administrators can create and manage all repositories, user accounts, and teams from the *Web UI*.  
3f3717 70 Administrators can create and manage all repositories, user accounts, and teams from the *JSON RPC interface* using the [Gitblit Manager](%GCURL%manager-${project.releaseVersion}.zip) or your own custom tooling. 
a5086d 71 Administrators can create and manage all repositories, user accounts, and teams from the *command-line* using SSH & the [Powertools plugin](https://github.com/gitblit/gitblit-powertools-plugin).
ed9953 72
493ab0 73 ### Integration with Your Infrastructure
ed9953 74
69eeaa 75 - Extendable by plugins
fa54be 76 - Groovy push hook scripts
6e15cb 77 - Pluggable user service mechanism
JM 78     - LDAP authentication with optional LDAP-controlled Team memberships
2659e7 79     - Redmine authentication
JM 80     - SalesForce.com authentication
81     - Windows authentication
82     - PAM authentication
6e15cb 83     - Custom authentication, authorization, and user management
ed9953 84 - Rich RSS feeds
JM 85 - JSON-based RPC mechanism
fb289c 86 - Java Client RSS/JSON API library for custom integration
ed9953 87
JM 88 ### Backup Strategy
89
3f3717 90 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](%GCURL%fedclient-${project.releaseVersion}.zip).  Similarly, you can use the federation mechanism to aggregate individual workspace Gitblit instances to a common, centralized server.
9b72a2 91
ed9953 92 ### Java Runtime Requirement
JM 93
e22185 94 Gitblit requires a Java 7 Runtime Environment (JRE) or a Java 7 Development Kit (JDK).
ed9953 95
f90dc6 96 [jgit]: http://eclipse.org/jgit "Eclipse JGit Site"
b774de 97 [git]: http://git-scm.com "Official Git Site"