From 25945b8fead989cca09a23983623b63ce36dcc0c Mon Sep 17 00:00:00 2001
From: Christian Cleberg <hello@cleberg.net>
Date: Mon, 8 Jan 2024 20:11:17 -0600
Subject: feat: total re-write from Emacs org-mode to Zola markdown

---
 content/blog/2023-09-15-gitweb.md | 77 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 77 insertions(+)
 create mode 100644 content/blog/2023-09-15-gitweb.md

(limited to 'content/blog/2023-09-15-gitweb.md')

diff --git a/content/blog/2023-09-15-gitweb.md b/content/blog/2023-09-15-gitweb.md
new file mode 100644
index 0000000..8952cdb
--- /dev/null
+++ b/content/blog/2023-09-15-gitweb.md
@@ -0,0 +1,77 @@
++++
+date = 2023-09-15
+title = "GitWeb via Nginx"
+description = "A guide to self-hosting GitWeb using the Nginx web server."
++++
+
+## Overview
+
+[GitWeb](https://git-scm.com/book/en/v2/Git-on-the-Server-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.
+
+See below for the final result:
+
+![Gitweb](https://img.cleberg.net/blog/20230915-gitweb/gitweb.png)
+
+## Install Dependencies
+
+To start, you'll need install the following packages:
+
+```sh
+sudo apt install git gitweb fcgiwrap nginx
+```
+
+## Configure Nginx
+
+Once installed, create an Nginx configuration file.
+
+```sh
+sudo nano /etc/nginx/sites-available/git.example.com
+```
+
+```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;
+        }
+}
+```
+
+To make the configuration active, you need to symlink it and then
+restart Nginx.
+
+```sh
+sudo ln -s /etc/nginx/sites-available/git.example.com /etc/nginx/sites-enabled/git.example.com
+sudo systemctl restart nginx.service
+```
+
+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 [gitweb.conf](https://git-scm.com/docs/gitweb.conf) file.
+
+```sh
+sudo nano /etc/gitweb.conf
+```
-- 
cgit v1.2.3