# Accessing git repositories over HTTP

Starting with indefero 1.2, git repositories are provided via http,
featuring read-only and read-write access with full integration with
indefero's access control mechanisms.

## Access git repositories

The repositories are available under http://YOURHOST/BASEPATH/r/PROJECT.

For authentication, use the "extra password" which you can find on your
profile page.

## Setup

The main thing to setup is git_repositories and git_remote_url in
src/IDF/conf/idf.php

git_remote_url should match http://YOURHOST/BASEPATH/r/%s, while
git_repositories points to the local directory supposed to contain the
repositories like /PATH/TO/REPOSITORIES/%s.git.

## Setup requirements when using PHP over FastCGI

There are a couple of things to setup when using PHP over FastCGI, as compared
to mod_php or similar integrated mechanisms:

- You will need to setup a RewriteRule for mod_rewrite (in case of Apache,
  analogous mechanisms might need to be setup for other http daemons), which
  passes through the Authorization HTTP Header of a request.

  In case of mod_rewrite, the necessary line is
  one of (depending on server configuration):
      RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization},L]
      RewriteRule .* - [E=REMOTE_USER:%{HTTP:Authorization},L]

- The FastCGI adaptor must allow large requests to be handled by PHP,
  otherwise push might fail.

  For mod_fcgid, this is the FcgidMaxRequestLen option, or MaxRequestLen in
  older versions. Set this option to some large enough value - there is no
  issue with RAM use, as another option defines the limit after which the
  request is backed on disk, which can remain small.

## When migrating from syncgit

HTTP access can be used in parallel to syncgit.

If you want to disable syncgit, just undo the changes detailled
in doc/syncgit.mdtext:
- In src/IDF/conf/idf.php keep git_repositories
- In src/IDF/conf/idf.php adapt git_remote_url to http://host/basepath/r/%s 
- In src/IDF/conf/idf.php remove idf_plugin_syncgit*
- Remove the cronjob that called gitcron.php
- Disable the git daemon (eg. /etc/event.d/local-git-daemon)
- You can remove the git user and group, if you also adapt the git repositories
  to be owned by the www user.