From 26591037eefdc7e815b30a91eaea8f5dbd4c1764 Mon Sep 17 00:00:00 2001
From: Mroik <mroik@delayed.space>
Date: Mon, 26 Jan 2026 18:48:24 +0100
Subject: Add README

---
 README.md | 31 +++++++++++++++++++++++++++++++
 1 file changed, 31 insertions(+)
 create mode 100644 README.md

(limited to 'README.md')

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..1b9e83b
--- /dev/null
+++ b/README.md
@@ -0,0 +1,31 @@
+Before building you need to download the `cgit` source code. There's already a
+reference to it as a submodule. To download just run `git submodule update
+--init --recursive`.
+
+After running the container you just configure your webserver to use the exposed
+unix socket (`./stuff/fcgi.sock`) with `fastcgi`.
+
+Following a Caddy config example using the official caddy docker alpine image:
+```Cadyfile
+my.cgit.domain {
+	handle_path /static/* {
+		root /srv/cgit
+		file_server
+	}
+
+	handle {
+		reverse_proxy unix//fcgi.sock {
+			transport fastcgi {
+				env SCRIPT_FILENAME /cgit/www/cgit.cgi
+			}
+		}
+	}
+}
+```
+
+Obviously when using caddy you have to mount the cgit `www` folder onto the
+caddy container as well. The same goes for the socket exposed by this container.
+So everytime you restart this container you need to restart the caddy container.
+
+Note that `SCRIPT_FILENAME` is set to the location of cgit file in the cgit
+container.
-- 
cgit v1.3