path: root/gitweb/README
diff options
authorMartin Waitz <>2006-10-03 08:03:28 (GMT)
committerJunio C Hamano <>2006-10-03 08:09:56 (GMT)
commit128eead19821ba18e2912ebf30e5621d08735e79 (patch)
tree147b404251f50b30b013437d4ec9e96a04bc920a /gitweb/README
parente70866f53a8d31cde6cfff6396ba0d1f64029afb (diff)
gitweb: document webserver configuration for common gitweb/repo URLs.
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 <> Signed-off-by: Junio C Hamano <>
Diffstat (limited to 'gitweb/README')
1 files changed, 25 insertions, 1 deletions
diff --git a/gitweb/README b/gitweb/README
index 27c6dac..61c7ab5 100644
--- a/gitweb/README
+++ b/gitweb/README
@@ -1,4 +1,5 @@
GIT web Interface
The one working on:
@@ -6,7 +7,8 @@ The one working on:
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:
@@ -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
+ DocumentRoot /pub/git
+ RewriteEngine on
+ RewriteRule ^/(.*\.git/(?!/?(info|objects|refs)).*)?$ /cgi-bin/gitweb.cgi%{REQUEST_URI} [L,PT]
+The above configuration expects your public repositories to live under
+/pub/git and will serve them as,
+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 <>