Self-host con Docker

Una única imagen (Node.js + SQLite + sistema de ficheros), un volumen (/data), un puerto (8788). Requisitos mínimos: 1 vCPU / 1 GB RAM.

Arranque

curl -O https://raw.githubusercontent.com/ull/andarama/main/deploy/docker/docker-compose.yml
echo "APP_SECRET=$(openssl rand -hex 32)" > .env
echo "PUBLIC_URL=http://localhost:8788" >> .env
docker compose up -d

Abre http://localhost:8788/studio/ y registra el primer usuario (será administrador).

Variables de entorno

Variable	Descripción
APP_SECRET	Obligatoria. Secreto de instancia (openssl rand -hex 32)
PUBLIC_URL	URL pública (obligatoria detrás de proxy/TLS)
SMTP_HOST/PORT/USER/PASS, EMAIL_FROM	Email transaccional (opcional; sin él, modo log)
OIDC_ISSUER/CLIENT_ID/CLIENT_SECRET/ALLOWED_DOMAINS	SSO institucional (opcional)
S3_ENDPOINT/BUCKET/ACCESS_KEY_ID/SECRET_ACCESS_KEY	Almacenamiento S3/MinIO en lugar del FS local (opcional)
TURNSTILE_SITE_KEY/SECRET	Anti-spam en formularios (opcional)

TLS automático

Descomenta el servicio caddy del compose, edita Caddyfile con tu dominio y fija PUBLIC_URL=https://tu-dominio.

Equivalencias con Cloudflare

D1 se convierte en SQLite (fichero), R2 en sistema de ficheros o S3/MinIO, KV en tabla SQLite, Queues en cola en proceso persistida, Durable Objects en servidor ws integrado y Analytics Engine en tabla SQLite. El mismo binario sirve Studio, API, visor y tiempo real.

Actualización

docker compose pull && docker compose up -d

Las migraciones se aplican automáticamente al arrancar, con copia de seguridad previa de la base de datos en /data.

Copias de seguridad

deploy/docker/backup.sh <destino> hace una copia consistente de SQLite (VACUUM INTO) y sincroniza los medios. Prográmalo con cron; para replicación continua considera litestream.