diff options
| author | Martin Kagamino Lehoux <martin@lehoux.net> | 2026-02-13 08:46:23 +0100 |
|---|---|---|
| committer | Martin Kagamino Lehoux <martin@lehoux.net> | 2026-02-13 08:46:23 +0100 |
| commit | a2ba8e05e65648dde0551ee831ee2f5744a847a0 (patch) | |
| tree | 27fa7e8fef7197bf0e56db669e1371a63535ab58 /README.md | |
| parent | 17be2fcb106ddc9c36628e9f5dece28369affc30 (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.md | 46 |
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 ./... +``` |
