README

   1 GWVP
   2 ====
   3
   4 ALPHA
   5
   6 GWVP stands for "git over web via php". It was written for one purpose of
   7 being a quick and simple way of getting a git repo online using only usernames
   8 and passwords rather then having to deal with ssh keys.
   9
  10 Installation
  11 ============
  12
  13 Ubuntu
  14 You'll need to add following packages:
  15
  16 ```
  17 sudo apt-get install php5-sqlite git apache2 php5-cli
  18 ```
  19
  20 Assuming you clone the repository into /opt/gwvp you will then need to make
  21 some changes to the rewrite, apache and gwvp configuration (assuming /gwvp
  22 for the url also)
  23
  24 #### Apache config
  25
  26 This goes in /etc/apache2/conf.d/gwvp.conf
  27 ```
  28 Alias /gwvp /opt/gwvp/www
  29
  30 <Directory /opt/gwvp/www>
  31         DirectoryIndex index.php
  32         AllowOverride All
  33 </Directory>
  34 ```
  35
  36 #### Rewrite
  37
  38 Edit the file /opt/gwvp/www/.htaccess and change the top line to match your
  39 base url
  40
  41 ```
  42 RewriteBase /gwvp
  43 ...
  44 ```
  45
  46
  47 #### GWVP Config
  48
  49 in /opt/gwvp/www/config.php data directory is (by default) /opt/gwvp/data
  50 This directory must be read/write by the apache user. The following will
  51 give the apache user write access to the file system:
  52
  53 ```
  54 mkdir -p /opt/gwvp/data
  55 sudo chown www-data:www-data /opt/gwvp/data
  56 ```
  57
  58 Done - now you should browse to http://yourmachine/gwvp and login as admin
  59 or user with a password of "password". Hopefully the rest is fairly straight
  60 forward and self-explanitory, but there will be a help system coming soon(tm)