Runbook

Installation screen remains visible

Check docker compose ps for healthy database and WordPress services.
Run docker compose --profile tools run --rm wp-cli /scripts/bootstrap.sh.
Inspect docker compose logs wordpress db without printing secret values.

NGINX returns 502

Run docker compose ps and docker compose exec proxy nginx -t.
Check the WordPress health status and docker compose logs proxy wordpress.
Confirm the request host is exactly azionelab.org; unknown hosts return 404.

Images or theme are missing

Confirm wordpress_data is mounted in both WordPress and WP-CLI.
Run docker compose --profile tools run --rm wp-cli -c 'wp theme status azionelab'.
Verify file ownership before changing permissions; never make the tree world-writable.

Certificate issuance fails

Verify public DNS, inbound port 80, the operator email, and staging mode. Request a missing /.well-known/acme-challenge/ path: an NGINX 404 confirms the route is yours. Avoid repeated production-CA retries while debugging.

Rollback

Revert the deployment commit and rebuild while preserving all named volumes. Restore database/files only for a data rollback and only from a verified coordinated backup.

1.2 KiB Raw Blame History