Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Newer
Older
100644 51 lines (35 sloc) 1.881 kb
b90a077 @sitaramc initial version
authored
1 # gitolite administration
2
3 ## #server server-side administration
4
5 The following activities require command line access to the server. They are
6 usually one-time or rarely done activities.
7
8 * Changing anything in the [rc][] file.
9 * Installing custom [hooks][], whether to all repos or just some repos.
10 * Moving [existing][] repos into gitolite control.
11
12 Please read the [WARNINGS][] page first.
13
14 ## #adminrepo access control via the gitolite-admin repo
15
16 Most day-to-day administration of a gitolite site happens like this:
17
18 * [clone][] the gitolite-admin repo to your workstation
19 * make appropriate changes
20 * add, commit, and push
21
22 ### #conf the conf/gitolite.conf file
23
24 Most of gitolite's power is in the conf/gitolite.conf file, which specifies
25 detailed access control for repos. Everything except [adding users][users]
26 happens from this file.
27
28 Here is an example of a simple conf/gitolite.conf file.
29
30 @staff = dilbert alice # line 1
31 @projects = foo bar # line 2
32
33 repo @projects baz # line 3
34 RW+ = @staff # line 4
35 - master = ashok # line 5
36 RW = ashok # line 6
37 R = wally # line 7
38
39 config hooks.emailprefix = '[%GL_REPO] ' # line 8
40
41 Use the following links to learn more:
42
43 * The basic [syntax][] -- comments, whitespace, include files, etc.
44 * Defining [groups][], as in lines 1 and 2.
45 * Adding and removing [users][].
46 * Adding and removing [repos][], as in line 3.
47 * Defining access [rules][], as in lines 4, 5, 6, and 7.
48 * Gitolite [options][].
49 * [Git config][git-config] keys and values, as in line 8.
50 * ["Wild"][wild] repos -- ad hoc, user-created, repos.
Something went wrong with that request. Please try again.