gitolite/doc/index.mkd
Sitaram Chamarty de40461d9a document overhaul
- explicit 'list' gives way to mindmap, ...
  - 'fm2mt.pl' to produce master-toc.mkd from the mindmap
  - mkdoc no longer ignores master-toc.mkd, calls fm2mt.pl itself

and LOTS of changes to the actual docs
2012-04-05 21:42:22 +05:30

2.2 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 current gitolite (v2) users)

For current gitolite (call it "g2" for convenience) users,

  • [Why][g3why] I rewrote gitolite.
  • Development [status][dev-status].
  • Specific migration [issues and steps][g2migr].
  • 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 httpd 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.