Troubleshooting

Symptom	Likely cause / fix
No cert / TLS error at the domain	`TRAEFIK_ENTRYPOINT` or `TRAEFIK_CERTRESOLVER` name wrong, or DNS not resolving yet. Check `docker logs <traefik>`.
404 from Traefik	Service not on the `proxy` network, or `MANGA_API_HOST` mismatch. Confirm `docker network inspect proxy` lists `manga-api`.
`fetch` fails in the userscript, `curl` works	Origin missing from `ALLOWED_ORIGINS`, or mixed content (backend not HTTPS).
401 with the right token	Trailing space/newline in `API_TOKEN`; regenerate and restart.
Panel button absent	URL didn't match an adapter, or user scripts disabled in Bromite.
`compose ... config` errors about `API_TOKEN`	Run compose from the dir with `.env`, or export the vars.
Web UI logs everyone out unexpectedly	`API_TOKEN` or `WEB_PASSWORD` was rotated — sessions are stateless and keyed off both, so this is expected, not a bug.
curl to asurascans.com/demonicscans.org gets challenged	Cloudflare's block is IP-reputation-based, not universal or permanent — re-check live rather than assume; see Architecture / repo `CLAUDE.md`.
A manga site changed its URL shape, adapter stops matching	Update the regex in that site's adapter in `manga-bookmark.user.js`, re-verify against a live page (Playwright or a direct probe) before trusting it.

Backend config reference and endpoint list: Backend-API.