{"id":2487,"date":"2024-12-16T06:25:22","date_gmt":"2024-12-16T06:25:22","guid":{"rendered":"https:\/\/cdblog.cdstealer.com\/?p=2487"},"modified":"2025-03-07T15:46:13","modified_gmt":"2025-03-07T15:46:13","slug":"gitweb","status":"publish","type":"post","link":"https:\/\/cdblog.cdstealer.com\/?p=2487","title":{"rendered":"GitWeb"},"content":{"rendered":"\n

Emerge git with the required USE flags:<\/strong><\/p>\n\n\n\n

emerge -aq dev-vcs\/git curl gpg iconv nls pcre perl safe-directory webdav cgi cvs highlight keyring tk<\/code><\/pre>\n\n\n\n
Configure Apache vhosts (NO AUTH):<\/strong><\/p>\n\n\n\n
<VirtualHost *:443>\n\t  SSLEngine on\n        <FilesMatch \"\\.(cgi|shtml|phtml|php)$\">\n          SSLOptions +StdEnvVars\n        <\/FilesMatch>\n        <Directory \"\/var\/www\/localhost\/cgi-bin\">\n          SSLOptions +StdEnvVars\n        <\/Directory>\n          SSLCertificateFile \/path\/to\/cert.crt\n          SSLCertificateKeyFile \/path\/to\/key.key\n          ServerName git.example.com\n          DocumentRoot \/usr\/share\/gitweb\n\t  Options ExecCGI FollowSymLinks SymLinksIfOwnerMatch\n\t<Location \/>\n\t  SSLRequireSSL\n\t  Require all allowed\n<\/mark>          RewriteOptions inherit\n<\/mark>          AllowOverride All<\/mark><\/em>\n\t<\/Location>\n        <Directory \/usr\/share\/gitweb>\n          Require all granted\n          RewriteOptions inherit\n          AllowOverride All\n          Options ExecCGI FollowSymLinks SymLinksIfOwnerMatch\n          <Files gitweb.cgi>\n            SetHandler cgi-script\n          <\/Files>\n        <\/Directory>\n\t  DirectoryIndex gitweb.cgi\n          SetEnv  GITWEB_CONFIG  \/etc\/gitweb.conf\n        <IfModule headers_module>\n          RequestHeader set X-HTTPS 1\n        <\/IfModule>\n<\/VirtualHost>\n\nBasic \/etc\/gitweb.conf<\/strong><\/code><\/pre>\n\n\n\n
$projectroot = '\/path\/to\/gitroot';\n@git_base_url_list = ( 'git@example.com', );\n$site_name = \"Smack my git up!\";\n$default_projects_order = \"age\";\n$projects_list_group_categories = 1;\n$feature{'blame'}{'default'} = [1];\n$feature{'highlight'}{'default'} = [1];<\/code><\/pre>\n\n\n\n
Adjust git-daemon<\/strong>
Gitweb allows browsing repositories via HTTP, but if you will be pulling from your repositories using the git:\/\/ protocol, you'll also want to run git-daemon. On Gentoo, this is really easy, just edit \/etc\/conf.d\/git-daemon as you see fit. eg:<\/p>\n\n\n\n
GITDAEMON_OPTS=\"--syslog --enable=receive-pack --export-all\"<\/pre>\n\n\n\n
This exports all repositories within the git root. It also allows pushing file to the server.

You will also need to ensure that any clients to connect to port tcp\/9418 (default)<\/p>\n\n\n\n
Setup the git user<\/strong><\/p>\n\n\n\n
useradd -m git -d \/path\/to\/githome -s \/usr\/bin\/git-shell
mkdir \/path\/to\/githome\/.ssh
cat \/home\/A_USER\/.ssh\/id_rsa.pub > \/path\/to\/githome\/.ssh\/authorized_keys
chmod 700 \/path\/to\/githome\/.ssh
chmod 600 \/path\/to\/githome\/.ssh\/authorized_keys
setfacl -PRdm u:apache:rwx \/path\/to\/githome<\/pre>\n\n\n\n
Create an Empty Repository<\/strong><\/p>\n\n\n\n
su -s \/bin\/bash git
cd
mkdir name.git
cd name.git
git init --bare
echo \"This is a test\" > description
git remote add origin git@example.com:name.git<\/pre>\n\n\n\n
Set Configuration Options<\/h2>\n\n\n\n
Execute the following on a client (optional)
To see available options execute: git help --config<\/p>\n\n\n\n
git config --global init.defaultBranch master
git config --global core.editor vim
git config --global alias.st status
git config --global alias.co checkout
git config --global alias.br branch
git config --global alias.up rebase
git config --global alias.ci commit
git config --global user.name \"A_USER\"
git config --global user.email A_USER@example.com
git config --global color.ui true
git config --global --add --bool push.autoSetupRemote true<\/pre>\n\n\n\n
Clone Repo<\/h2>\n\n\n\n
cd to local git
git clone git@example.com:name.git
cd name
touch README.md
git add README.md
git ci -m \"Initial Setup\"
git push
git br branch_name
git co branch_name
mkdir testdir
touch testdir\/testfile
git add .
git ci -m \"init\"
git push # Pushes to your upstream branch
git push origin branch_name:master # Pushes to the master branch<\/pre>\n\n\n\n
Web Authentication<\/strong><\/h2>\n\n\n\n
Note:  I did not have any success using dbmmanage.  Use htdbm instead.<\/p>\n\n\n\n
Create the database file and add a user:
Do not store this in the root of web eg: \/var\/www\/locahost\/htdocs, but make sure apache can get to the file.<\/p>\n\n\n\n
htdbm -cm -TGDBM <path\/to\/dbm_file> <user><\/pre>\n\n\n\n
-c - create db
-m - use MD5 hashing
-T - set the format of the db file<\/p>\n\n\n\n
Set the permission for apache:<\/p>\n\n\n\n
chown apache: <path\/to\/dbm_file>
chmod 640 <path\/to\/dbm_file><\/pre>\n\n\n\n
Add code to vhosts:
You can apply this to files, directories etc. Here I've done it for the whole subdomain. Replace the 3 highlighted italic lines above with the code below, excluding the start\/end tags.<\/p>\n\n\n\n
    <Location \/>\n      AuthName \"Private\"\n      AuthType Basic\n      AuthBasicProvider dbm\n      AuthDBMType GDBM\n      AuthDBMUserFile \"\/path\/to\/dbm_file\"\n      Require valid-user \n      Require all denied\n      RewriteOptions inherit\n      AllowOverride All\n    <\/Location><\/code><\/pre>\n\n\n\n
Reload apache and browse to protected area and you should be prompted to authenticate.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
A good explanation can be found here<\/a> for the web config.<\/p>\n\n\n\n
<\/p>\n","protected":false},"excerpt":{"rendered":"
Emerge git with the required USE flags: Configure Apache vhosts (NO AUTH): Adjust git-daemonGitweb allows browsing repositories via HTTP, but if you will be pulling from your repositories using the git:\/\/ protocol, you'll also want to run git-daemon. On Gentoo, this is really easy, just edit \/etc\/conf.d\/git-daemon as you see fit. eg: GITDAEMON_OPTS=\"--syslog --enable=receive-pack --export-all\" … Continue reading GitWeb<\/span> →<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[45,213,106,18],"class_list":["post-2487","post","type-post","status-publish","format-standard","hentry","category-gentoo","tag-apache","tag-gentoo","tag-git","tag-linux"],"_links":{"self":[{"href":"https:\/\/cdblog.cdstealer.com\/index.php?rest_route=\/wp\/v2\/posts\/2487","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/cdblog.cdstealer.com\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/cdblog.cdstealer.com\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/cdblog.cdstealer.com\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/cdblog.cdstealer.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=2487"}],"version-history":[{"count":22,"href":"https:\/\/cdblog.cdstealer.com\/index.php?rest_route=\/wp\/v2\/posts\/2487\/revisions"}],"predecessor-version":[{"id":2547,"href":"https:\/\/cdblog.cdstealer.com\/index.php?rest_route=\/wp\/v2\/posts\/2487\/revisions\/2547"}],"wp:attachment":[{"href":"https:\/\/cdblog.cdstealer.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=2487"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/cdblog.cdstealer.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=2487"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/cdblog.cdstealer.com\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=2487"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}