gitolite/doc/index.mkd
Sitaram Chamarty cf3dd885fc (some docfixes)
2012-04-21 22:29:56 +05:30

2.3 KiB

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.

#g2 (for older gitolite (v1.x and v2.x) users)

For users of gitolite v2.x (call it "g2" for convenience),

  • [Why][g3why] I rewrote gitolite.
  • Development [status][dev-status].
  • Information on [migrating][migr] from g2 to g3.
  • [Trying][trying] out gitolite.
  • 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].

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.

#what What is gitolite?

Gitolite is an access control layer on top of git. Here are the features that most people see:

  • Use a single unix user ("real" user) on the server.
  • Provide access to many gitolite users:
    • they are not "real" users,
    • they do not get shell access.
  • Control access to many git repositories:
    • read access controlled at the repo level,
    • write access controlled at the branch/tag/file/directory level, including who can rewind, create, and delete branches/tags.
  • 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 [http][] if you prefer (this may require root access).

#contact contact

#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.