d78bbe8c3e
- added comments to easy install to help do it manually
- README: some stuff moved to tips doc, brief summary of extras
(over gitosis) added
- INSTALL: major revamp, easy install and manual install,
much shorter and much more readable!
plus other docs changed as needed, and updated the tips doc to roll in
some details from "update.mkd" in the "ml" branch
76 lines
2.7 KiB
Markdown
76 lines
2.7 KiB
Markdown
# installing gitolite
|
|
|
|
This document tells you how to install gitolite. After the install is done,
|
|
you may want to see the "admin" document for adding users, repos, etc.
|
|
|
|
There's an easy install script for Linux, and for other Unixes there's a
|
|
slightly more manual process. Both are explained here.
|
|
|
|
In this document:
|
|
|
|
* easy install
|
|
* manual install
|
|
* other notes
|
|
* next steps
|
|
|
|
----
|
|
|
|
### easy install
|
|
|
|
There is an easy install script that makes installing very easy for the common
|
|
case. **This script is meant to be run on your workstation, not on the
|
|
server!** It will take care of all the server side work, *and* get you
|
|
"push-to-admin" too :-) In short, it does **everything**!
|
|
|
|
Assumptions:
|
|
|
|
* you have a server to host gitolite
|
|
* git is installed on that server (and so is perl)
|
|
* you have a userid on that server
|
|
* you have ssh-pubkey (password-less) login to that userid
|
|
* (if you have only password access, run `ssh-keygen -t rsa` to create a
|
|
new keypair if needed, then run `ssh-copy-id user@host`)
|
|
* you have a clone or an archive of gitolite somewhere on your workstation
|
|
|
|
If so, just `cd` to that clone and run `src/00-easy-install.sh` and follow the
|
|
prompts! (Running it without any arguments shows you usage plus other useful
|
|
info).
|
|
|
|
#### advantages over the older install methods
|
|
|
|
* all ssh problems reduced to **just one pre-requisite**: enable ssh pubkey
|
|
(password-less) access to the server from your workstation first
|
|
* the script takes care of all the server side work
|
|
* when done:
|
|
* you get two different pubkeys (the original one for command line
|
|
access as before, plus a new one, created by the script, for gitolite
|
|
access)
|
|
* you can admin gitolite by commit+push a "gitolite-admin" repo, just
|
|
like gitosis (i.e., full "push to admin" power!)
|
|
|
|
#### disadvantages
|
|
|
|
* has been tested only with Linux
|
|
|
|
### manual install
|
|
|
|
If for some reason you cannot use the easy-install method, (for example,
|
|
you're on a non-Linux machine), it's not very complicated. Just open the file
|
|
`src/00-easy-install.sh` in a nice, syntax coloring, text editor, and follow
|
|
the instructions marked "MANUAL" :-)
|
|
|
|
### other notes
|
|
|
|
* If you edit `~/.gitolite.rc` and change any paths, be sure to keep the
|
|
perl syntax -- you *don't* have to know perl to do so, it's fairly easy to
|
|
guess in this limited case
|
|
|
|
* the config file is (by default) at `~/.gitolite/conf/gitolite.conf`,
|
|
though you can change its location in the "rc" file. Edit the file as you
|
|
wish. The comments in the example file (`conf/example.conf`) ought to be
|
|
clear enough but let me know if not
|
|
|
|
### next steps
|
|
|
|
See the "admin" document for how to add users, etc.
|