aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorMartin Kagamino Lehoux <martin@lehoux.net>2026-02-13 08:46:23 +0100
committerMartin Kagamino Lehoux <martin@lehoux.net>2026-02-13 08:46:23 +0100
commita2ba8e05e65648dde0551ee831ee2f5744a847a0 (patch)
tree27fa7e8fef7197bf0e56db669e1371a63535ab58 /README.md
parent17be2fcb106ddc9c36628e9f5dece28369affc30 (diff)
Replace Caddyfile.example with README.md
Move the Caddy config example into the README alongside build, usage, and test instructions.
Diffstat (limited to 'README.md')
-rw-r--r--README.md46
1 files changed, 46 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..207a7cd
--- /dev/null
+++ b/README.md
@@ -0,0 +1,46 @@
+# kagapics
+
+A lightweight, self-hosted photo gallery for collecting trip photos from friends. Single Go binary, no database, no runtime dependencies.
+
+## Build
+
+```sh
+go build -o gallery .
+```
+
+## Usage
+
+### Create a gallery
+
+```sh
+./gallery create <name> <password> [--data ./gallery-data] [--no-thumbs]
+```
+
+### Start the server
+
+```sh
+./gallery serve [--addr :8080] [--data ./gallery-data]
+```
+
+### Caddy reverse proxy
+
+```caddy
+{
+ supervisor {
+ ./gallery serve --addr :8020 --data ./gallery-data {
+ dir /home/ubuntu
+ restart_policy always
+ }
+ }
+}
+
+pics.example.com {
+ reverse_proxy localhost:8020
+}
+```
+
+## Test
+
+```sh
+go test ./...
+```