Skip to content

Commit

Permalink
gitweb: document webserver configuration for common gitweb/repo URLs.
Browse files Browse the repository at this point in the history
Add a small apache configuration which shows how to use apache
to put gitweb and GIT repositories at the same URL.

Signed-off-by: Martin Waitz <tali@admingilde.org>
Signed-off-by: Junio C Hamano <junkio@cox.net>
  • Loading branch information
Martin Waitz authored and Junio C Hamano committed Oct 3, 2006
1 parent e70866f commit 128eead
Showing 1 changed file with 25 additions and 1 deletion.
26 changes: 25 additions & 1 deletion gitweb/README
Original file line number Diff line number Diff line change
@@ -1,12 +1,14 @@
GIT web Interface
=================

The one working on:
http://www.kernel.org/git/

From the git version 1.4.0 gitweb is bundled with git.


How to configure gitweb for your local system:
How to configure gitweb for your local system
---------------------------------------------

You can specify the following configuration variables when building GIT:
* GITWEB_SITENAME
Expand All @@ -29,6 +31,28 @@ You can specify the following configuration variables when building GIT:
environment variable will be loaded instead of the file
specified when gitweb.cgi was created.


Webserver configuration
-----------------------

If you want to have one URL for both gitweb and your http://
repositories, you can configure apache like this:

<VirtualHost www:80>
ServerName git.domain.org
DocumentRoot /pub/git
RewriteEngine on
RewriteRule ^/(.*\.git/(?!/?(info|objects|refs)).*)?$ /cgi-bin/gitweb.cgi%{REQUEST_URI} [L,PT]
</VirtualHost>

The above configuration expects your public repositories to live under
/pub/git and will serve them as http://git.domain.org/dir-under-pub-git,
both as cloneable GIT URL and as browseable gitweb interface.
If you then start your git-daemon with --base-path=/pub/git --export-all
then you can even use the git:// URL with exactly the same path.



Originally written by:
Kay Sievers <kay.sievers@vrfy.org>

Expand Down

0 comments on commit 128eead

Please sign in to comment.