| 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. |