e9febd037c
v0.16 dropped TOML/%{env}% for a JSON datastore-only config, with all other
settings living in Postgres. This migrates the deployment and fixes the
fallout found during the first real run.
- config/config.json: v0.16 JSON bootstrap (root = PostgreSql datastore;
DB password via the EnvironmentVariable secret type, so it stays
commit-safe). Replaces the now-dead config.toml.
- docker-compose.yml: bind-mount config.json -> /etc/stalwart/config.json
(the image's --config path) and use a named volume for /var/lib/stalwart;
the old anonymous volumes were orphaned on every recreate ("lost settings").
Drop the dead config.toml mount.
- .gitignore: exclude local operational artifacts that hold real secrets +
mail data (_backup/, _validate/, *.dump, export/). config/config.json is
intentionally tracked (secret-free).
- CLAUDE.md: "Lessons learned — v0.16 first real run" — config model, the
anonymous-volume trap, full-FQDN store endpoints, per-listener PROXY trust,
one-instance-per-store, recovery mode + argon2 password reset, ACME, backups.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
78 lines
2.9 KiB
YAML
78 lines
2.9 KiB
YAML
# tailwart — Stalwart mailbox as a Tailscale sidecar (NO WAN presence).
|
|
#
|
|
# The container shares ts-stalwart's network namespace, so its only interfaces
|
|
# are lo and tailscale0. All mail ports listen on the tailnet only; the public
|
|
# edge is the separate caddy/ layer-4 proxy, which can run on another host.
|
|
#
|
|
# Prereq: the shared tailnet infra (Postgres the-record-prod, Redis
|
|
# slo-time-prod, Garage) must be up, and the stalwart role/db/bucket created
|
|
# (see README). Bring up: docker compose up -d
|
|
|
|
name: tailwart
|
|
|
|
services:
|
|
|
|
ts-stalwart:
|
|
image: tailscale/tailscale:latest
|
|
hostname: ${STALWART_MAGIC_NAME}
|
|
environment:
|
|
TS_AUTHKEY: ${TS_OAUTH_CLIENT_SECRET}?ephemeral=true
|
|
TS_EXTRA_ARGS: --advertise-tags=tag:stalwart
|
|
TS_HOSTNAME: ${STALWART_MAGIC_NAME}
|
|
TS_ACCEPT_DNS: "true"
|
|
TS_AUTH_ONCE: "true"
|
|
TS_USERSPACE: "false"
|
|
TS_ENABLE_HEALTH_CHECK: "true"
|
|
TS_LOCAL_ADDR_PORT: "127.0.0.1:9002"
|
|
dns: [1.1.1.1, 1.0.0.1]
|
|
devices:
|
|
- /dev/net/tun:/dev/net/tun
|
|
cap_add:
|
|
- NET_ADMIN
|
|
- NET_RAW
|
|
healthcheck:
|
|
test: ["CMD", "wget", "-qO-", "http://127.0.0.1:9002/healthz"]
|
|
interval: 10s
|
|
timeout: 5s
|
|
retries: 6
|
|
start_period: 30s
|
|
restart: unless-stopped
|
|
|
|
stalwart:
|
|
image: stalwartlabs/stalwart:v0.16.7
|
|
network_mode: "service:ts-stalwart"
|
|
environment:
|
|
# Consumed by config/config.toml via its %{env:NAME}% macros. Keeping
|
|
# secrets in env (not the mounted toml) means the toml is commit-safe.
|
|
STALWART_DB_NAME: ${STALWART_DB_NAME}
|
|
STALWART_DB_USER: ${STALWART_DB_USER}
|
|
STALWART_DB_PASSWORD: ${STALWART_DB_PASSWORD}
|
|
DB_HOST: ${DB_MAGIC_NAME}.${TS_TAILNET}
|
|
REDIS_URL: redis://${REDIS_MAGIC_NAME}.${TS_TAILNET}:6379/${STALWART_REDIS_DB}
|
|
S3_ENDPOINT: http://${GARAGE_MAGIC_NAME}.${TS_TAILNET}:3900
|
|
S3_REGION: ${GARAGE_REGION}
|
|
S3_BUCKET: ${STALWART_S3_BUCKET}
|
|
S3_ACCESS_KEY: ${GARAGE_ACCESS_KEY_ID}
|
|
S3_SECRET_KEY: ${GARAGE_SECRET_ACCESS_KEY}
|
|
STALWART_HOSTNAME: ${STALWART_HOSTNAME}
|
|
STALWART_DOMAIN: ${STALWART_DOMAIN}
|
|
STALWART_SMARTHOST: ${STALWART_SMARTHOST}
|
|
STALWART_FALLBACK_ADMIN_SECRET: ${STALWART_FALLBACK_ADMIN_SECRET}
|
|
volumes:
|
|
# Bootstrap config (v0.16 JSON): tells Stalwart only where Postgres lives;
|
|
# all other settings live in the DB. Mounted at the image's default
|
|
# --config path (/etc/stalwart/config.json). Secret comes from the
|
|
# STALWART_DB_PASSWORD env above, referenced via the EnvironmentVariable
|
|
# secret type inside the file — so this stays commit-safe.
|
|
- ./config/config.json:/etc/stalwart/config.json:ro
|
|
# Working dir: ACME cert cache + outbound queue spool. Named volume (not
|
|
# anonymous) so a recreate doesn't orphan it and drop queued mail/certs.
|
|
- stalwart-data:/var/lib/stalwart
|
|
depends_on:
|
|
ts-stalwart:
|
|
condition: service_healthy
|
|
restart: unless-stopped
|
|
|
|
volumes:
|
|
stalwart-data:
|