diff options
Diffstat (limited to 'content/blog/2023-09-15-self-hosting-gitweb.org')
-rw-r--r-- | content/blog/2023-09-15-self-hosting-gitweb.org | 71 |
1 files changed, 71 insertions, 0 deletions
diff --git a/content/blog/2023-09-15-self-hosting-gitweb.org b/content/blog/2023-09-15-self-hosting-gitweb.org new file mode 100644 index 0000000..71e2a22 --- /dev/null +++ b/content/blog/2023-09-15-self-hosting-gitweb.org @@ -0,0 +1,71 @@ +#+date: <2023-09-15> +#+title: Self-Hosting Gitweb via Nginx +#+description: + + +* Overview + +[[https://git-scm.com/book/en/v2/Git-on-the-Server-GitWeb][GitWeb]] is a +simple web-based visualizer for git repositories. By default, GitWeb +will only run with the =lighttpd= or =webrick= web servers. + +However, this guide will show you how to keep GitWeb running in the +background and display information for all repositories in a chosen +directory. + +* Install Dependencies + +To start, you'll need install the following packages: + +#+begin_src sh +sudo apt install git gitweb fcgiwrap nginx +#+end_src + +* Configure Nginx + +Once installed, create an Nginx configuration file. + +#+begin_src sh +sudo nano /etc/nginx/sites-available/git.example.com +#+end_src + +#+begin_src conf +server { + listen 80; + server_name example.com; + + location /index.cgi { + root /usr/share/gitweb/; + include fastcgi_params; + gzip off; + fastcgi_param SCRIPT_NAME $uri; + fastcgi_param GITWEB_CONFIG /etc/gitweb.conf; + fastcgi_pass unix:/var/run/fcgiwrap.socket; + } + + location / { + root /usr/share/gitweb/; + index index.cgi; + } +} +#+end_src + +To make the configuration active, you need to symlink it and then +restart Nginx. + +#+begin_src sh +sudo ln -s /etc/nginx/sites-available/git.example.com /etc/nginx/sites-enabled/git.example.com +sudo systemctl restart nginx.service +#+end_src + +The GitWeb application should now be available via the URL you set in +the Nginx configuration above. + +* Customize GitWeb + +If you need to, you can customize many things about Gitweb by editing +the [[https://git-scm.com/docs/gitweb.conf][gitweb.conf]] file. + +#+begin_src sh +sudo nano /etc/gitweb.conf +#+end_src |