# Troubleshooting

- [Gateway agent provisioning and check-in](./gateway-agent-provisioning.md)

## Common issues

- Frontend can’t reach backend (check `NEXT_PUBLIC_API_URL`)
- Auth errors (check `AUTH_MODE`, tokens)
- DB connection/migrations

> **Note**
> Expand with concrete symptoms + fixes as issues are discovered.