Paul Martin
2016-04-30 a502d96a860456ec5e8c96761db70f7cabb74751
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>        
fa357d 26         <tr><th>Issues</th><td><a href="${project.issuesUrl}">GitHub</a></td></tr>
f6b200 27         <tr><th>Discussion</th><td><a href="${project.forumUrl}">Gitblit Group</a></td></tr>
f35a98 28         <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>
493ab0 29         </tbody>
b774de 30         </table>
493ab0 31     </div>
4ef60d 32 </div>
52b26f 33
JM 34 ## What is Gitblit?
85c2e6 35
ed9953 36 Gitblit is an open-source, pure Java stack for managing, viewing, and serving [Git][git] repositories.  
JM 37 It's designed primarily as a tool for small workgroups who want to host centralized repositories.
85c2e6 38
ed9953 39 ### GO: Single-Stack Solution
3b5289 40
ed9953 41 *Gitblit GO* is an integrated, single-stack solution based on Jetty.
b774de 42
ed9953 43 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 44
45 This is what you should download if you want to go from zero to Git in less than 5 mins.
b774de 46
ed9953 47 ### WAR: For Your Servlet Container
493ab0 48 *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 49
ed9953 50 ### You decide how to use Gitblit
3b5289 51
ed9953 52 Gitblit can be used as a dumb repository viewer with no administrative controls or user accounts.  
JM 53 Gitblit can be used as a complete Git stack for cloning, pushing, and repository access control.  
54 Gitblit can be used without any other Git tooling (including actual Git) or it can cooperate with your established tools.
2179fb 55
a5086d 56 ### All Transports
JM 57
58 The SSH, HTTP, & GIT protocols are supported and ready-to-go out of the box.
59
60 ### Issue tracking with branch-based pull requests
61
62 Gitblit blends elements of GitHub, BitBucket, and Gerrit to provide a streamlined collaboration workflow based on branches within the primary repository.
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*.  
3f3717 67 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 68 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 69
493ab0 70 ### Integration with Your Infrastructure
ed9953 71
69eeaa 72 - Extendable by plugins
fa54be 73 - Groovy push hook scripts
6e15cb 74 - Pluggable user service mechanism
JM 75     - LDAP authentication with optional LDAP-controlled Team memberships
2659e7 76     - Redmine authentication
JM 77     - SalesForce.com authentication
78     - Windows authentication
79     - PAM authentication
6e15cb 80     - Custom authentication, authorization, and user management
ed9953 81 - Rich RSS feeds
JM 82 - JSON-based RPC mechanism
fb289c 83 - Java Client RSS/JSON API library for custom integration
ed9953 84
JM 85 ### Backup Strategy
86
3f3717 87 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 88
ed9953 89 ### Java Runtime Requirement
JM 90
e22185 91 Gitblit requires a Java 7 Runtime Environment (JRE) or a Java 7 Development Kit (JDK).
ed9953 92
f90dc6 93 [jgit]: http://eclipse.org/jgit "Eclipse JGit Site"
b774de 94 [git]: http://git-scm.com "Official Git Site"