Git Repositories

docker-compose example file
[simple-git-host.git] / README.md
1 simple-git-host
2 ===============
3
4 Simple, easy web to install a git repositories 'server'.
5
6 | Type    | Information |
7 |:------- |:----------- |
8 | Author  | Cyrille Pontvieux <jrd@enialis.net> |
9 | Licence | GPL version 3 (or, at your option, any later version). See [LICENSE](LICENSE) for a full version and this [Quick guide](http://www.gnu.org/licenses/quick-guide-gplv3.html) to understand the licence |
10 | Version | __1.1__ |
11
12 Difference with other solutions
13 --------------------------------------
14 - GNU/Linux only
15 - sh scripts for the server
16 - php scripts for the web interface and perl for gitweb
17 - few dependencies:
18     - sh (or any compatible shell)
19     - web server
20     - php
21     - sudo package
22     - git
23
24 Features
25 -----------
26 - authentification via __ssl keys__ via ssh.
27 - __anonymous read-only__ access.
28 - handling of *users* and *repositories* directly on the __web interface__.
29 - authentification and __rights per repository__: *administrator*, *regular*, *readonly*
30 - users and rights are described in simple __plain text files__.
31 - simple __history__ and __repository browser__ in the web interface.
32 - branches and tags __download__
33 - full view of a repository with the help of __gitweb__.
34 - __synchronisation__ *to* and *from* an external repository, i.e. *github*.
35
36 Installation
37 ------------
38 A `configure` script is available to set parameters like git system user, path location and other information.
39 Next step is a regular `make` and `make install`.
40
41 You will then find in the `gen` folder a example configuration for your webserver:
42
43 - nginx
44 - apache http