feat(deploy): central Postgres + scheduler split for Proxmox 24/7 backfill

Add a server compose (full stack, Postgres on the LAN, scheduler on, host-visible
pgdata bind mount) and a localdev compose (webapp only, no DB, scheduler off) that
points at the central DB. Document the single-shared-database topology, the
exactly-one-scheduler rule, and YOUTUBE_API_KEY for unattended backfill that does
not depend on a 7-day OAuth refresh token.
This commit is contained in:
npeter83 2026-06-11 16:35:00 +02:00
parent 93e1d7afc2
commit 79e328af8d
4 changed files with 136 additions and 1 deletions

58
docker-compose.server.yml Normal file
View file

@ -0,0 +1,58 @@
# Server (Proxmox LXC) deployment of the full Subfeed stack.
#
# This is the "central" instance: it owns the single shared Postgres database and
# runs the background scheduler (RSS poll, enrichment, recent/deep backfill) 24/7.
# Local dev machines and any future VPS point their DATABASE_URL at this Postgres
# and run with SCHEDULER_ENABLED=false (see docker-compose.localdev.yml) so exactly
# one scheduler ever writes to the DB.
#
# Usage (inside the LXC, from the project root which is the bind-mounted /docker):
# export COMPOSE_FILE=docker-compose.server.yml # or put it in .env
# docker compose up -d --build
#
# Postgres data lives in ./pgdata (a host-visible bind mount under /docker/subfeed)
# so it is covered by the host's /docker backups; logical pg_dump backups via
# scripts/backup.sh remain the portable mechanism for moving between hosts.
services:
db:
image: postgres:16-alpine
environment:
POSTGRES_USER: ${POSTGRES_USER:-subfeed}
POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-subfeed}
POSTGRES_DB: ${POSTGRES_DB:-subfeed}
volumes:
- ./pgdata:/var/lib/postgresql/data
ports:
# Published on the LAN so the local dev webapp uses this central DB.
- "5432:5432"
healthcheck:
test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER:-subfeed} -d ${POSTGRES_DB:-subfeed}"]
interval: 5s
timeout: 5s
retries: 12
restart: unless-stopped
api:
build:
context: .
dockerfile: Dockerfile
env_file: .env
environment:
DATABASE_URL: postgresql+psycopg://${POSTGRES_USER:-subfeed}:${POSTGRES_PASSWORD:-subfeed}@db:5432/${POSTGRES_DB:-subfeed}
# This instance owns the background sync. Keep it true here and false everywhere else.
SCHEDULER_ENABLED: "true"
depends_on:
db:
condition: service_healthy
ports:
# Exposed on the LAN for status/health checks only. Interactive Google login
# needs a public HTTPS redirect URL (set up later); backfill runs regardless.
- "${APP_PORT:-8080}:8000"
healthcheck:
test: ["CMD", "python", "-c", "import urllib.request; exit(0 if urllib.request.urlopen('http://localhost:8000/healthz').status == 200 else 1)"]
interval: 15s
timeout: 5s
retries: 5
start_period: 25s
restart: unless-stopped