From 68a4efd49e7d1c842b871bd201db0461be27f7d0 Mon Sep 17 00:00:00 2001
From: Bradley Taunt <bt@btxx.org>
Date: Mon, 4 Nov 2024 08:33:13 -0500
Subject: Include initial gotwebd wiki page

---
 pages/wiki.md     |  1 +
 pages/wiki/got.md | 72 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 73 insertions(+)
 create mode 100644 pages/wiki/got.md

diff --git a/pages/wiki.md b/pages/wiki.md
index ef3db4f..f724730 100644
--- a/pages/wiki.md
+++ b/pages/wiki.md
@@ -26,6 +26,7 @@ This is the homepage for my personal wiki. All sub-directories are listed below.
 ## Version Control Systems
 
 * [cgit](/wiki/cgit)
+* [got](/wiki/got)
 
 ---
 
diff --git a/pages/wiki/got.md b/pages/wiki/got.md
new file mode 100644
index 0000000..2ee84c4
--- /dev/null
+++ b/pages/wiki/got.md
@@ -0,0 +1,72 @@
+# got (Game of Trees)
+
+This page contains a comprehensive guide to setting up `got` and `gotwebd` on an OpenBSD server through `httpd` and `haproxy`.
+
+For reference, you can see a **live version** [here](https://got.btxx.org).
+
+The following assumes you have already setup an active `git` server on your OpenBSD instance.
+
+## Installing `got`
+
+Since `got` is a first-class citizen on OpenBSD, installation is very easy:
+
+~~~sh
+pkg_add got gotwebd
+~~~
+
+* `/var/www/got/public/`: Default location for Git repositories served by gotwebd
+* `/var/www/htdocs/gotwebd/`: Directory containing HTML, CSS, and image files used by gotwebd.
+* `/var/www/run/gotweb.sock`: Default location for the gotwebd listening socket.
+
+Read more on the [official man pages](https://gameoftrees.org/gotwebd.8.html)
+
+## Configuration
+
+Include the following to your existing `/etc/httpd.conf` file. Be sure to change the domain and directory location to match your own.
+
+~~~sh
+types { include "/usr/share/misc/mime.types" }
+
+server "got.btxx.org" {
+    listen on 127.0.0.1 port 8080
+    root "/htdocs/gotwebd"
+    location "/" {
+        fastcgi socket "/run/gotweb.sock"
+    }
+}
+~~~
+
+Next create (or edit if it already exists) the main `/etc/gotwebd.conf` file:
+
+~~~sh
+server "localhost" {
+    repos_path "/got/public"
+    site_name "btxx projects"
+    site_owner "Bradley Taunt"
+    site_link "got.btxx.org"
+}
+~~~
+
+**Important**: You will also need to fix permissions to avoid warnings:
+
+~~~sh
+doas mkdir -p /var/www/got/tmp
+doas chown www:daemon /var/www/got/tmp
+~~~
+
+You may also be required to give user `www` access to the main `htdocs/gotwebd` directory:
+
+~~~sh
+doas chown www:www /var/www/htdocs/gotwebd`
+~~~
+
+## Running Our Services
+
+Now we simply run and enable all our required services:
+
+~~~sh
+doas rcctl enable httpd slowcgi gotwebd
+doas rcctl start httpd slowcgi gotwebd
+~~~
+
+**And you should be good to go!**
-- 
cgit v1.2.3-54-g00ecf