working git-http-backend proxy poc code
[gwvp.git] / README
1 GWVP
2 ====
3
4 Git over Web Via PHP is a project to do something i've wanted to have a long time - a web based git remote 
5 with administration and all git related activities happening over http/https. Git has this now, its called
6 git-http-backend and its quite broken. If you read its man page it'll tell you this:
7
8                 To enable anonymous read access but authenticated write access,
9            require authorization with a LocationMatch directive:
10
11                <LocationMatch "^/git/.*/git-receive-pack$">
12                        AuthType Basic
13                        AuthName "Git Access"
14                        Require group committers
15                        ...
16                </LocationMatch>
17
18 This will never work in a month of sundays, but yet its been in the man page and been un-fixed now for a year
19 and besides that i've decided i want a web based one. Im sick of git over ssh with ssh keys, its annoying
20 when it can be done with user/password auth over https.
21
22 Thats what the project is designed to do - give people the ability to administrate a set of a git repo's via
23 a web interface and have the same web interface for pull and push.
24
25 What you will ultimately be able to do is:
26 1) get list of git repos (with an interface like gitweb)
27 2) create users and assign permissions into repo's
28 3) create repos
29 4) import repos
30
31 but most importantly:
32 git add remote origin https://username@server/git/myrepo.git
33 git push
34
35 How it Works
36 ============
37 Initially this thing will have a fairly boring interface for creating/contorlling users and repos while
38 also pushing directly back to git-http-backend AND providing the authentication interface IT needs to function
39
40 Gitweb.cgi may also be incorporated as the git view tool - but thats less important at this point