Fix: typos in clone commands were creating empty repos
[gitosis.git] / example.conf
1 # this config file tries to show a bit of everything, most real life
2 # configurations really only need a "group" section with "members" and
3 # "writable"
4
5 [gitosis]
6 ## To override the default ~/repositories path
7 # repositories = repositories
8
9 ## Allow gitweb to show all known repositories. If you want gitweb,
10 ## you need either this or a [repo foo] section for each repository
11 ## you want visible in gitweb.
12 gitweb = no
13
14 ## Allow git-daemon to publish all known repositories. As with gitweb,
15 ## this can be done globally or per-repository.
16 daemon = no
17
18 ## Logging level, one of DEBUG, INFO, WARNING, ERROR, CRITICAL
19 loglevel = DEBUG
20
21 [group quux]
22 members = jdoe wsmith @anothergroup
23 writable = foo bar baz/thud
24 readonly = xyzzy
25
26 ## You can use groups just to avoid listing users multiple times. Note
27 ## no writable= or readonly= lines.
28 [group anothergroup]
29 members = alice bill
30
31 ## You can play fancy tricks by making some repositories appear with
32 ## different names in different contexts. Not really supported
33 ## everywhere (e.g. gitweb) and can be confusing -- experts only.
34 map writable visiblename1 = actualname1
35 map readonly visiblename2 = actualname2
36
37 [repo foo]
38 ## Allow gitweb to show this repository.
39 gitweb = yes
40
41 ## Oneline description of the project, mostly for gitweb.
42 description = blah blah
43
44 ## Owner of this repository. Used in gitweb list of projects.
45 owner = John Doe
46
47 ## Allow git-daemon to publish this repository.
48 daemon = yes
49
50 # Special group that adds support for repositories of the form
51 # user/<user>/<foo>.git. Otherwise admins would have to add specific
52 # entries for every single user repo, and that would quickly become an
53 # admin nightmare!
54 #
55 # The following config group will allow *write* access to
56 # user/<user>/<foo>.git for the owner ($user) and the @admins group
57 #
58 # If you want to allow a specific user (Bob) to have write access to
59 # a specific user repo (belonging to Alice), you will need to add a
60 # specific group describing Alice's user repo and list Bob in the
61 # members field there as normal. That will supplement the normal
62 # access from the wild-card group entries. Sorry, this *will* require
63 # admin work.
64 [group user-write]
65 members = $user @admins
66 writable = users/$user/*
67
68 # And this will add read-only access to the same set of modules for
69 # anyone in the @amino group
70 [group other-user-readonly]
71 members = @amino
72 readonly = users/*/*
73
74 # Finally, add gitweb and git:// access to the user repositories too.
75 # The $user in the "repo" line is important, as that's how we look up
76 # the username when generating the Description and Owner fields in
77 # gitweb output. If we can find user details for $user, we will
78 # substitute their name in the Description field, replacing
79 # '$username'
80 [repo users/$user/*]
81 description = Public repository for $username
82
83 [gitweb]
84 ## Where to make gitweb link to as it's "home location".
85 ## NOT YET IMPLEMENTED.
86 # homelink = http://example.com/