2012-03-16 02:54:47 +01:00
|
|
|
# Hosting git repositories
|
|
|
|
|
|
|
|
|
|
Gitolite allows you to setup git hosting on a central server, with
|
|
|
|
|
fine-grained access control and many more powerful features.
|
|
|
|
|
|
|
|
|
|
Here's more on [what][] it is and [why][] you might need it.
|
|
|
|
|
|
2012-04-05 18:01:23 +02:00
|
|
|
<font color="gray">
|
|
|
|
|
|
2012-04-16 07:07:45 +02:00
|
|
|
## #g2 (for older gitolite (v1.x and v2.x) users)
|
2012-04-05 18:01:23 +02:00
|
|
|
|
2012-04-16 07:07:45 +02:00
|
|
|
For users of gitolite v2.x (call it "g2" for convenience),
|
2012-03-16 02:54:47 +01:00
|
|
|
|
|
|
|
|
* [Why][g3why] I rewrote gitolite.
|
2012-04-05 18:01:23 +02:00
|
|
|
* Development [status][dev-status].
|
2012-03-16 02:54:47 +01:00
|
|
|
* Specific migration [issues and steps][g2migr].
|
|
|
|
|
|
2012-04-05 18:01:23 +02:00
|
|
|
</font>
|
2012-03-16 02:54:47 +01:00
|
|
|
|
2012-04-05 18:01:23 +02:00
|
|
|
## #ql quick links
|
2012-03-16 02:54:47 +01:00
|
|
|
|
2012-04-17 03:13:13 +02:00
|
|
|
* [Trying][trying] out gitolite.
|
2012-04-05 18:01:23 +02:00
|
|
|
* Minimum [requirements][req].
|
|
|
|
|
* Here's how to do a [quick install, setup, and clone][qi].
|
|
|
|
|
* Don't know ssh well enough? [Learn][ssh]. It's **IMPORTANT**.
|
|
|
|
|
* Add [users][] and [repos][].
|
|
|
|
|
* Learn about fine-grained access control with the [conf][] file.
|
|
|
|
|
* Explain gitolite to your [users][user].
|
2012-03-16 02:54:47 +01:00
|
|
|
|
2012-04-05 18:01:23 +02:00
|
|
|
The rest of the documentation is in the "master index" link at the top of each
|
|
|
|
|
page on this website. This is the first place you should search when looking
|
|
|
|
|
for specific information.
|
2012-03-16 02:54:47 +01:00
|
|
|
|
|
|
|
|
## #what What is gitolite?
|
|
|
|
|
|
|
|
|
|
Gitolite is an access control layer on top of git. Here are the features that
|
|
|
|
|
most people see:
|
|
|
|
|
|
2012-04-05 18:01:23 +02:00
|
|
|
* Use a single unix user ("real" user) on the server.
|
|
|
|
|
* Provide access to many gitolite users:
|
2012-04-17 03:13:13 +02:00
|
|
|
* they are not "real" users,
|
|
|
|
|
* they do not get shell access.
|
2012-04-05 18:01:23 +02:00
|
|
|
* Control access to many git repositories:
|
2012-04-17 03:13:13 +02:00
|
|
|
* read access controlled at the repo level,
|
2012-03-16 02:54:47 +01:00
|
|
|
* write access controlled at the branch/tag/file/directory level,
|
2012-04-17 03:13:13 +02:00
|
|
|
including who can rewind, create, and delete branches/tags.
|
2012-04-05 18:01:23 +02:00
|
|
|
* Can be installed without root access, assuming git and perl are already
|
|
|
|
|
installed.
|
|
|
|
|
* Authentication is most commonly done using sshd, but you can also use
|
2012-04-15 07:47:44 +02:00
|
|
|
[http][] if you prefer (this may require root access).
|
2012-03-16 02:54:47 +01:00
|
|
|
|
|
|
|
|
## #contact contact
|
|
|
|
|
|
|
|
|
|
* author: sitaramc@gmail.com, sitaram@atc.tcs.com
|
|
|
|
|
* mailing list: gitolite@googlegroups.com
|
|
|
|
|
* list subscribe address : gitolite+subscribe@googlegroups.com
|
|
|
|
|
* IRC: #git and #gitolite on freenode. Note that I live in India (UTC+0530
|
|
|
|
|
time zone).
|
|
|
|
|
|
|
|
|
|
## #license license
|
|
|
|
|
|
|
|
|
|
The gitolite *code* is released under GPL v2. See COPYING for details.
|
|
|
|
|
|
|
|
|
|
The gitolite documentation is provided under a [Creative Commons
|
|
|
|
|
Attribution-NonCommercial-ShareAlike 3.0 Unported
|
|
|
|
|
License](http://creativecommons.org/licenses/by-nc-sa/3.0/).
|
