Troubleshooting

Common issues and their fixes. Start here before opening a support ticket.

Can't reach the UI

If http://localhost doesn't respond:

• Check the proxy container: docker compose ps orchestack-proxy.
• Check port 80 isn't bound by another process: sudo lsof -i :80.
• Check proxy logs: docker compose logs orchestack-proxy.

Pipeline failed

Open the Airflow UI → find the failed DAG run → click the red task → View logs. The error message will pinpoint whether it's a source connectivity issue (Airbyte), a SQL error (dbt), or a quality check failure (Great Expectations).

A service is stuck

If a cold service won't stop (e.g. OpenMetadata stays running for hours):

1. Check platform.service_sessions for stale sessions that aren't being garbage-collected.
2. From the dashboard, Force stop the service (requires can_force_stop).
3. If that fails, docker compose stop <service> from the host.

Where logs live

• Service logs: docker compose logs -f <service>
• Pipeline logs: Airflow UI, or ./config/airflow/logs/
• Platform audit log: platform.audit_log table
• dbt run logs: The dashboard Logs tab