Deployment

This application ships with an immutable, single‑container image that includes PHP‑FPM, Nginx, and your code. By default it uses SQLite and auto‑runs migrations on start.

Build (locally)

docker build \
  --target=prod \
  -t tonehaus-app:latest \
  -f docker/php/Dockerfile \
  .

Run

docker run -d \
  --name tonehaus \
  -p 8080:8080 \
  -e APP_ENV=prod \
  -e APP_SECRET=change_me \
  -e LASTFM_API_KEY=your_api_key \
  tonehaus-app:latest

Notes

Health endpoint: GET /healthz (e.g., curl http://localhost:8080/healthz)
Migrations: RUN_MIGRATIONS_ON_START=1 by default (safe to re‑run)
Cache warmup is executed on boot; APP_SECRET is required

Persistence options

SQLite (default)

Data file at var/data/database.sqlite
Use a volume for durability:

docker run -d \
  -v tonehaus_sqlite:/var/www/html/var/data \
  ...

Postgres

Provide DATABASE_DRIVER=postgres and a DATABASE_URL, e.g.:

postgresql://user:password@host:5432/dbname?serverVersion=16&charset=utf8

You can disable automatic migrations with RUN_MIGRATIONS_ON_START=0 and run them manually:

docker exec tonehaus php bin/console doctrine:migrations:migrate --no-interaction

Environment variables

APP_ENV (prod recommended in production)
APP_SECRET (required; random string)
LASTFM_API_KEY
APP_ALLOW_REGISTRATION (env override for public registration)
DATABASE_DRIVER (sqlite default, or postgres)
DATABASE_URL (when using Postgres)
DATABASE_SQLITE_PATH (optional)
RUN_MIGRATIONS_ON_START (default 1)

Reverse proxy / TLS

Place behind your ingress/proxy (e.g., Nginx, Traefik, or a cloud load balancer)
Terminate TLS at the proxy and forward to the container’s port 8080
Ensure proxy sends X-Forwarded-* headers

Zero‑downtime tips

Build then run a new container alongside the old one, switch traffic at the proxy
Keep SQLite on a named volume, or use Postgres for shared state across replicas

2.0 KiB Raw Permalink Blame History Unescape Escape