gitolite docs<\/a> show how to do this. Here’s what my config looks like (the (hopefully) only line you might have to change is highlighted):<\/p>\n\r\n# --------------------------------------------\r\n# Per-repo authorization based on gitolite ACL\r\n# Include this in gitweb.conf\r\n# See doc\/3-faq-tips-etc.mkd for more info\r\n\r\n# please note that the author does not have personal experience with gitweb\r\n# and does not use it. Some testing may be required. Patches welcome but\r\n# please make sure they are tested against a "github" version of gitolite\r\n# and not an RPM or a DEB, for obvious reasons.\r\n\r\n# HOME of the gitolite user\r\nmy $gl_home = $ENV{HOME} = "\/home\/git";\r\n\r\n# the following variables are needed by gitolite; please edit before using\r\n\r\n# this should normally not be anything else\r\n$ENV{GL_RC} = "$gl_home\/.gitolite.rc";\r\n\r\n# this can have different values depending on how you installed.\r\n$ENV{GL_BINDIR} = "\/usr\/local\/bin";\r\n\r\n# finally the user name\r\n$ENV{GL_USER} = $cgi->remote_user || "gitweb";\r\n\r\n# now get gitolite stuff in...\r\nunshift @INC, $ENV{GL_BINDIR};\r\nrequire gitolite_rc; gitolite_rc -> import;\r\nrequire gitolite; gitolite -> import;\r\n\r\n# set project root etc. absolute paths\r\n$ENV{GL_REPO_BASE_ABS} = ( $REPO_BASE =~ m(^\/) ? $REPO_BASE : "$gl_home\/$REPO_BASE" );\r\n$projects_list = $projectroot = $ENV{GL_REPO_BASE_ABS};\r\n\r\n$export_auth_hook = sub {\r\n my $repo = shift;\r\n # gitweb passes us the full repo path; so we strip the beginning\r\n # and the end, to get the repo name as it is specified in gitolite conf\r\n return unless $repo =~ s\/^\\Q$projectroot\\E\\\/?(.+)\\.git$\/$1\/;\r\n\r\n # check for (at least) "R" permission\r\n my ($perm, $creator) = &repo_rights($repo);\r\n return ($perm =~ \/R\/);\r\n};\r\n\r\n###############################\r\n# ORIGINAL GITWEB CONFIG FILE #\r\n###############################\r\n# path to git projects (<project>.git)\r\n#$projectroot = "\/home\/git\/repositories";\r\n\r\n# directory to use for temp files\r\n$git_temp = "\/tmp";\r\n\r\n# target of the home link on top of all pages\r\n#$home_link = $my_uri || "\/";\r\n\r\n# html text to include at home page\r\n#$home_text = "indextext.html";\r\n\r\n# file with project list; by default, simply scan the projectroot dir.\r\n#$projects_list = $projectroot;\r\n\r\n# stylesheet to use\r\n#@stylesheets = ("static\/gitweb.css");\r\n\r\n# javascript code for gitweb\r\n#$javascript = "static\/gitweb.js";\r\n\r\n# logo to use\r\n#$logo = "static\/git-logo.png";\r\n\r\n# the 'favicon'\r\n#$favicon = "static\/git-favicon.png";\r\n\r\n# git-diff-tree(1) options to use for generated patches\r\n#@diff_opts = ("-M");\r\n@diff_opts = ();\r\n<\/pre>\nConfiguring Apache<\/h2>\n
When configuring apache, you can either install gitweb as a subdirectory (example.com\/git) or a subdomain (git.example.com). I’ll cover both methods.<\/p>\n
Subdirectory Method<\/h4>\n
In your apache config file (probably \/etc\/apache2\/sites-enabled\/000-default if you just installed apache), insert the highlighted lines (my entire default config file is provided for context):<\/p>\n
\r\n<VirtualHost *:80>\r\n ServerAdmin webmaster@localhost\r\n\r\n DocumentRoot \/var\/www\r\n <Directory \/>\r\n Options FollowSymLinks\r\n AllowOverride None\r\n <\/Directory>\r\n <Directory \/var\/www\/>\r\n Options Indexes FollowSymLinks MultiViews\r\n AllowOverride None\r\n Order allow,deny\r\n allow from all\r\n <\/Directory>\r\n\r\n ScriptAlias \/cgi-bin\/ \/usr\/lib\/cgi-bin\/\r\n <Directory "\/usr\/lib\/cgi-bin">\r\n AllowOverride None\r\n Options +ExecCGI -MultiViews +SymLinksIfOwnerMatch\r\n Order allow,deny\r\n Allow from all\r\n <\/Directory>\r\n\r\n Alias \/git \/usr\/share\/gitweb\r\n <Directory "\/usr\/share\/gitweb">\r\n Options ExecCGI\r\n DirectoryIndex gitweb.cgi\r\n\r\n AuthType Basic\r\n AuthName "Gitweb"\r\n AuthUserFile \/home\/git\/htpasswd\r\n Require valid-user\r\n <\/Directory>\r\n\r\n ErrorLog ${APACHE_LOG_DIR}\/error.log\r\n\r\n # Possible values include: debug, info, notice, warn, error, crit,\r\n # alert, emerg.\r\n LogLevel warn\r\n\r\n CustomLog ${APACHE_LOG_DIR}\/access.log combined\r\n\r\n Alias \/doc\/ "\/usr\/share\/doc\/"\r\n <Directory "\/usr\/share\/doc\/">\r\n Options Indexes MultiViews FollowSymLinks\r\n AllowOverride None\r\n Order deny,allow\r\n Deny from all\r\n Allow from 127.0.0.0\/255.0.0.0 ::1\/128\r\n <\/Directory>\r\n\r\n<\/VirtualHost>\r\n<\/pre>\nNow, reload apache:<\/p>\n
\r\nsudo service apache2 restart\r\n<\/pre>\nand you should be able to login using your username and password you set up earlier by going to http:\/\/example.com\/git.<\/p>\n
Virtual Host Method<\/h4>\n
You’ll want to create a new config file to contain the virtual host (for example, \/etc\/apache2\/sites-enabled\/001-gitweb). Fill that config file with this:<\/p>\n
\r\n<VirtualHost *:80>\r\n ServerName git.example.com\r\n\r\n DocumentRoot \/usr\/share\/gitweb\r\n <Directory \/usr\/share\/gitweb>\r\n Options ExecCGI\r\n DirectoryIndex gitweb.cgi\r\n\r\n AuthType Basic\r\n AuthName "Gitweb"\r\n AuthUserFile \/home\/git\/htpasswd\r\n Require valid-user\r\n <\/Directory>\r\n<\/VirtualHost>\r\n<\/pre>\nNow, reload apache:<\/p>\n
\r\nsudo service apache2 restart\r\n<\/pre>\nand you should be able to login using your username and password you set up earlier by going to http:\/\/git.example.com.<\/p>\n","protected":false},"excerpt":{"rendered":"
Phew, that’s a long title. This post aims to start with a fresh install of Ubuntu 11.04 Server, installing git, gitolite, apache, and gitweb in order to do version control with access control and a web-based repository viewer. If you’re not running Ubuntu 11.04, most of this guide should still apply.<\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[5],"tags":[10,7,8,9,11,6],"class_list":["post-38","post","type-post","status-publish","format-standard","hentry","category-tutorial","tag-apache","tag-git","tag-gitolite","tag-gitweb","tag-tutorial-2","tag-ubuntu"],"_links":{"self":[{"href":"https:\/\/www.marcmorgan.ca\/index.php?rest_route=\/wp\/v2\/posts\/38","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.marcmorgan.ca\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.marcmorgan.ca\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.marcmorgan.ca\/index.php?rest_route=\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/www.marcmorgan.ca\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=38"}],"version-history":[{"count":63,"href":"https:\/\/www.marcmorgan.ca\/index.php?rest_route=\/wp\/v2\/posts\/38\/revisions"}],"predecessor-version":[{"id":107,"href":"https:\/\/www.marcmorgan.ca\/index.php?rest_route=\/wp\/v2\/posts\/38\/revisions\/107"}],"wp:attachment":[{"href":"https:\/\/www.marcmorgan.ca\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=38"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.marcmorgan.ca\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=38"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.marcmorgan.ca\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=38"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}