You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
54 lines
2.1 KiB
54 lines
2.1 KiB
Content-type: text/asciidoc |
|
|
|
How to use git-daemon |
|
===================== |
|
|
|
Git can be run in inetd mode and in stand alone mode. But all you want is |
|
let a coworker pull from you, and therefore need to set up a Git server |
|
real quick, right? |
|
|
|
Note that git-daemon is not really chatty at the moment, especially when |
|
things do not go according to plan (e.g. a socket could not be bound). |
|
|
|
Another word of warning: if you run |
|
|
|
$ git ls-remote git://127.0.0.1/rule-the-world.git |
|
|
|
and you see a message like |
|
|
|
fatal: The remote end hung up unexpectedly |
|
|
|
it only means that _something_ went wrong. To find out _what_ went wrong, |
|
you have to ask the server. (Git refuses to be more precise for your |
|
security only. Take off your shoes now. You have any coins in your pockets? |
|
Sorry, not allowed -- who knows what you planned to do with them?) |
|
|
|
With these two caveats, let's see an example: |
|
|
|
$ git daemon --reuseaddr --verbose --base-path=/home/gitte/git \ |
|
--export-all -- /home/gitte/git/rule-the-world.git |
|
|
|
(Of course, unless your user name is `gitte` _and_ your repository is in |
|
~/rule-the-world.git, you have to adjust the paths. If your repository is |
|
not bare, be aware that you have to type the path to the .git directory!) |
|
|
|
This invocation tries to reuse the address if it is already taken |
|
(this can save you some debugging, because otherwise killing and restarting |
|
git-daemon could just silently fail to bind to a socket). |
|
|
|
Also, it is (relatively) verbose when somebody actually connects to it. |
|
It also sets the base path, which means that all the projects which can be |
|
accessed using this daemon have to reside in or under that path. |
|
|
|
The option `--export-all` just means that you _don't_ have to create a |
|
file named `git-daemon-export-ok` in each exported repository. (Otherwise, |
|
git-daemon would complain loudly, and refuse to cooperate.) |
|
|
|
Last of all, the repository which should be exported is specified. It is |
|
a good practice to put the paths after a "--" separator. |
|
|
|
Now, test your daemon with |
|
|
|
$ git ls-remote git://127.0.0.1/rule-the-world.git |
|
|
|
If this does not work, find out why, and submit a patch to this document.
|
|
|