# git-server # DESCRIPTION Secure Git Server with more granular hooks capabilities than default git. This is intented to be a light-weight drop-in replacement for any standard git server, but provides more powerful server hooks. # USAGE If you do not already have a git server or git repo ready, then make one: ``` [admin@git-host ~]$ sudo useradd git [admin@git-host ~]$ sudo su - git -c 'git init --bare projectx' Initialized empty Git repository in /home/git/projectx/ [admin@git-host ~]$ ``` Put something like the following in ~git/.ssh/authorized_keys: ``` command="git-server KEY=USER1" ssh-rsa AAAA___blah_pub__ user1@workstation ``` Then, without any hooks, this user should have full access this repo: ``` [user1@dev ~]$ git config --global user.name 'Mr Developer User1' [user1@dev ~]$ git clone ssh://git@git-host:projectx [user1@dev ~]$ cd projectx [user1@dev projectx]$ echo 'Hello world' >> README [user1@dev projectx]$ git add README [user1@dev projectx]$ git commit -m 'First commit' README [user1@dev projectx]$ git push --set-upstream origin master [user1@dev projectx]$ ``` Then add whatever hooks you want: ``` [admin@git-host ~]$ sudo vi ~git/projectx/hooks/pre-read ``` Each hook can read the ENV settings defined in authorized_keys. See contrib/* for some working "hooks" examples. See hooks/INSTALL_ACL.md to setup granular read and write access and/or a simple push-notification instant deployment configuration.