gitolite/doc/qi.mkd

49 lines
1.4 KiB
Markdown
Raw Normal View History

# quick install, setup, and clone
2012-03-16 02:54:47 +01:00
(Please do not ignore the "assumptions" list below).
2012-03-16 02:54:47 +01:00
On the server:
2012-03-16 02:54:47 +01:00
# get the software
git clone -b g3 git://github.com/sitaramc/gitolite
2012-03-16 02:54:47 +01:00
# install it
gitolite/install -ln
2012-03-16 02:54:47 +01:00
# setup the initial repos with your key
gitolite setup -pk your-name.pub
2012-03-16 02:54:47 +01:00
On your workstation:
2012-03-16 02:54:47 +01:00
# clone the admin repo so you can start adding stuff
git clone git@host:gitolite-admin.git
2012-03-16 02:54:47 +01:00
## ASSUMPTIONS
2012-03-16 02:54:47 +01:00
* this is a fresh install, not a migration from the old gitolite (v1.x,
v2.x).
* on the server, your `$PATH` contains `$HOME/bin`. If you don't like that,
there are [other install methods][install].
* "your-name.pub" is your public key from your workstation.
* also, this key does not already have shell access to this gitolite
hosting user
* the setup command does not generate any warnings.
* if it does, please see [common errors][ce] and fix things before
continuing, or read the more complete [setup][] page.
## Notes
Note that the clone path is NOT "repositories/gitolite-admin.git". If you
clone with a path that includes "repositories/", the clone should fail. If
the clone *does* succeed, a subsequent push should fail :-) See
[this][ybpfail] for some details. If that doesn't make enough sense read all
of [ssh][].
2012-03-16 02:54:47 +01:00
## next steps
2012-03-16 02:54:47 +01:00
Next steps are usually adding [users][] and [repos][] and learning about
2012-03-16 02:54:47 +01:00
[access control][conf].