configuration for self hosting a spindle in docker
1# Copy this file to .env and fill in the required values.
2# Docker Compose loads .env automatically — no extra flags needed.
3
4# ── Required ───────────────────────────────────────────────────────────────────
5
6# Public hostname of this spindle (e.g. spindle.example.com or 192.0.2.1)
7SPINDLE_SERVER_HOSTNAME=
8
9# ATProto DID of the spindle owner
10# Find yours: https://bsky.app → Settings → Privacy and Security → Advanced
11SPINDLE_SERVER_OWNER=
12
13# ── Ports (host-side bindings) ─────────────────────────────────────────────────
14
15# Port Spindle listens on (host)
16SPINDLE_PORT=6555
17
18# Port OpenBao server is exposed on (host) — remove the openbao ports: mapping in
19# docker-compose.yml if you don't need local CLI/API access
20OPENBAO_PORT=8200
21
22# ── Advanced (safe to leave as-is) ────────────────────────────────────────────
23
24# Address Spindle binds inside the container
25SPINDLE_SERVER_LISTEN_ADDR=0.0.0.0:6555
26
27# Path to the Spindle SQLite database inside the container
28SPINDLE_SERVER_DB_PATH=/data/spindle.db
29
30# Directory for pipeline logs inside the container
31SPINDLE_PIPELINES_LOG_DIR=/var/log/spindle
32
33# Secrets backend — only "openbao" is supported
34SPINDLE_SERVER_SECRETS_PROVIDER=openbao
35
36# Internal address of the OpenBao proxy sidecar (do not change unless you rename the service)
37SPINDLE_SERVER_SECRETS_OPENBAO_PROXY_ADDR=http://openbao-proxy:8201
38
39# KV v2 mount name created by init-openbao.sh
40SPINDLE_SERVER_SECRETS_OPENBAO_MOUNT=spindle