Ubuntu Server Guide

Managing gitolite users and repositories
Adding a new user to gitolite is simple: just obtain their public SSH key and add it to the keydir directory
as $DESIRED_USER_NAME.pub. Note that the gitolite usernames don’t have to match the system
usernames - they are only used in the gitolite configuration file to manage access control. Similarly, users
are deleted by deleting their public key files. After each change, do not forget to commit the changes to git,
and push the changes back to the server with
g i t commit −a
g i t push o r i g i n master
Repositories are managed by editing the conf/ gitolite .conf file. The syntax is space separated, and simply
specifies the list of repositories followed by some access rules. The following is a default example
r e p o
g i t o l i t e −admin
RW+
=
admin
R
=
a l i c e
r e p o
p r o j e c t 1
RW+
=
a l i c e
RW
=
bob
R
=
d e n i s e
Using your server
Once a user’s public key has been imported by the gitolite admin and authorization granted to the user to
one or more repositories, the user can access repositories with the following command:
g i t c l o n e git@$SERVER_IP :$PROJECT_NAME. g i t
To add the server as a new remote for an existing git repository:
g i t remote add g i t o l i t e git@$SERVER_IP :$PROJECT_NAME. g i t
References
• Gitolite’s code repository provides access to source code.
• Gitolite’s documentation includes a “fool proof setup” guide and a cookbook with recipes for common
tasks.
• Gitolite’s maintainer has written a book, Gitolite Essentials, for more in-depth information about the
software.
• General information about git itself can be found at the Git homepage.
Client software implementations
Linux Network-Manager GUI for OpenVPN
Many Linux distributions including Ubuntu desktop variants come with Network Manager, a nice GUI to
configure your network settings. It also can manage your VPN connections. It is the default, but if in doubt
223

---

make sure you have package network−manager−openvpn installed.
Open the Network Manager GUI, select the VPN tab and then the ‘Add’ button. Select OpenVPN as the
VPN type in the opening requester and press ‘Create’. In the next window add the OpenVPN’s server name
as the ‘Gateway’, set ‘Type’ to ‘Certificates (TLS)’, point ‘User Certificate’ to your user certificate, ‘CA
Certificate’ to your CA certificate and ‘Private Key’ to your private key file. Use the advanced button to
enable compression (e.g. comp-lzo), dev tap, or other special settings you set on the server. Now try to
establish your VPN.