Quick guide on how to set up a git server with stagic html website.

What you will need 📋

1) Install Git

# sudo apt install git

2) Create Git user

# adduser git

3) Now you need to add your SSh keys

On computer

$ ssh-copy-id git@server_ip

If you want to allow other people to use your Git server, add their SSH keys alongside yours.

On server:

# su git
$ cd
$ mkdir .ssh && chmod 700 .ssh
$ touch .ssh/authorized_keys && chmod 600 .ssh/authorized_keys

4) Nearly done, now all you need to do is make a git repo.

# mkdir -p /srv/git
# chown git:git /srv/git
# su git
$ cd /srv/git
$ mkdir yourrepo.git
$ cd yourrepo.git
$ git init --bare

5) Add your server to your local repo

On computer

$ cd yourrepo
$ git init
$ git add .
$ git commit -m 'Initial commit'
$ git remote add origin git@gitserver:/srv/git/project.git
$ git push origin master

If you already have a Git repository from another server, you can do the following to add your new Git server alongside your old one.

$ cd yourrepo
$ git remote add server git@gitserver:/srv/git/project.git
$ git push server master && git push origin master

6) If you want to enable anybody to clone from your website do the following!

# sudo git daemon --reuseaddr --base-path=/srv/git/ /srv/git/ &
# sudo systemctl enable git-daemon
# sudo systemctl start git-daemon
# su git
# touch /srv/git/project.git/git-daemon-export-ok

Cloning your git repo

git clone git://your-server-ip-address/repository.git

Now you should be able to be able to clone without a ssh key!

Setting up Stagit for personal git website

Now that you have a Git server, you probably want a way to show off all of your repositories. I personally use Stagit for this because it is lightweight and stylish. I will assume you know how to make a website using Apache or Nginx.

1) First you need to install stagit (I have my own custom fork to make it easier to setup)

# cd /var/www
# git clone git://shipwreckt.co.uk/Stagit.git
# mkdir git
# chown git:git git
# mv stagit-fork/* git
# cd git
# sudo make clean install

2) Setup website.

# cd htmldir
# sh example_create.sh

Your static stagit website should be generated for you! Check by going to git.yourdomain.com.

3) Next you want to set up ownership, links, and descriptions for stagiit to display

Descriptions

# This is my git repo > /srv/git/yourrepo.git/description

URL

# git://yourdomain.com/yourrepo.git > /srv/git/yourrepo.git/url

Owner

# owner > /srv/git/yourrepo.git/owner

Update stagit

# sh /var/www/git/htmldir/example_create.sh

Now repete for all of your repos till all is correct!

3) Now you want it so stagit updates whenever there is an update, thankfully for you I have modified the script to work whenever a git commit is made!

# cp /var/www/git/example_post-receive.sh /srv/git /srv/git/yourgitrepo.git/hooks/post-receive

Now whenever you push a commit everything should update!

Overview

I hope this guide has helped you setup a kool git server! If there are any problems please contact me!