How to set up git over http?

by

First it is necessary to understand that there are 2 components to git-over-http: git and apache. These two are connected through a script with the name of git-http-backend. The challenge is to configure the interface between these two components, so that http requests to git are forwarded by apache.

Note: Security is outside the scope of this guide.

  1. Start out by installing git and apache2 using the package manager of your distribution.

  2. Add the modules needed by apache to enable git-over-http. These are cgi, alias and env

$ a2enmod cgi alias env
  1. Copy the following into /etc/apache2/httpd.conf (without removing whatever else it contains)
<VirtualHost *:80>
    SetEnv GIT_PROJECT_ROOT /data/git
    SetEnv GIT_HTTP_EXPORT_ALL
    SetEnv REMOTE_USER=$REDIRECT_REMOTE_USER
    ScriptAliasMatch \
        "(?x)^/(.*/(HEAD | \
        info/refs | \
        objects/(info/[^/]+ | \
        [0-9a-f]{2}/[0-9a-f]{38} | \
        pack/pack-[0-9a-f]{40}\.(pack|idx)) | \
        git-(upload|receive)-pack))$" \
        "/usr/lib/git/git-http-backend/$1"
    Alias /git /data/git
    <Directory /usr/lib/git>
        Options +ExecCGI -MultiViews +SymLinksIfOwnerMatch
        AllowOverride None
        Order allow,deny
        Allow from all
    </Directory>
</VirtualHost>
  1. Now replace the 2 occurrences of /data/git with the parent directory of your git repos on the server (don’t worry if you don’t have any repos yet, just use the directory where you intend to place it/them)

Also replace /usr/lib/git/git-http-backend with the location of git-http-backend on your system, which can be found using $ find / -name git-http-backend

It may be that on your system REDIRECT_REMOTE_USER actually overwrites a valid REMOTE_USER. If this setup doesn’t work when finished, try removing that line.

According to this source, it may be necessary to replace the last two lines within the Directory tag by Require all granted for apache 2.4 and above.

  1. Restart the apache server: $ apache2ctl -k graceful

Now the apache server is set up, but we’re not done yet, there are some important parts of setting up the repos that will affect whether this setup works or not.

  1. Set up the repo:
$ mkdir myrepo.git
$ cd myrepo.git
$ git init --bare --shared
$ cp hooks/post-update.sample hooks/post-update
$ git update-server-info
$ chown -R wwwrun:www

Here it is important to understand that the last line changes the owner of the repo to the apache2 user. This user may be different on your system. To find the apache user, execute $ ps aux | egrep '(apache|httpd)'. Then to find the group name of the user, execute $ id user-name. On my system the user is wwwrun and the group www. Replace accordingly.

  1. Use the repo

In order to use the repo, you need to know the url. For this setup the url is http://server.domain/myrepo.git

Note: https will not work.

When accessing the repo from a client, you just add it as a remote: 

$ git remote add origin http://server.domain/myrepo.git

Then you can interact with it like any other git repo.

More Related Contents:

  1. Cannot push Git to remote repository with http/https
  2. Setting up Git Server on Windows With git-http-backend.exe
  3. Git push requires username and password
  4. How to prune local tracking branches that do not exist on remote anymore
  5. How to squash commits in git after they have been pushed?
  6. Link to the issue number on GitHub within a commit message
  7. Setting up and using Meld as your git difftool and mergetool
  8. How do you use “git –bare init” repository?
  9. What’s the easiest way to deal with project configuration files?
  10. Who is “us” and who is “them” according to Git?
  11. heroku: src refspec master does not match any
  12. Git: can I suppress listing of ‘modified content’/dirty submodule entries in status, diff, etc?
  13. Pass an argument to a Git alias command
  14. How do I prevent an automerge using Git?
  15. Referencing the child of a commit in Git
  16. How can I know if `git gc –auto` has done something?
  17. Git rebase fails, ‘Your local changes to the following files would be overwritten by merge’. No local changes?
  18. Can I split an already split hunk with git?
  19. Multiple staging areas
  20. How to cleanup garbage in remote git repo
  21. Git: auto pull from repository?
  22. How to force push a reset to remote repository?
  23. How resolve multiple conflicts with “git mergetool” without having to close the editor between files?
  24. Why does git stash pop say that it could not restore untracked files from stash entry?
  25. View differences of branches with meld?
  26. Installing Latest version of git in ubuntu
  27. Support for password authentication was removed on August 13, 2021
  28. Why has git-filter-branch not rewritten tags?
  29. git – remote add origin vs remote set-url origin
  30. git clone with HTTPS or SSH remote?

Leave a Comment