Skip to main content

Troubleshooting

Services not starting​

make logs

postgres: FATAL: data directory has wrong ownership — run make reset to wipe and restart.

gateway: ECONNREFUSED postgres — DB not ready. Wait 10s and run make stop && make dev.

401 Unauthorized​

  • Key is invalid or revoked. Dashboard → API Keys to check.
  • Key not prefixed with aut_live_ — use the exact key from the dashboard.
  • Verify cookie is set: open browser DevTools → Application → Cookies.

403 Forbidden​

Request blocked by a policy rule. Dashboard → Logs → click the blocked request to see which rule triggered.

To allow it: Rules → find the rule → disable or edit it.

PII not being redacted​

Confirm the prompt contains a recognized pattern. Test with:

curl ... -d '{"messages":[{"role":"user","content":"My email is test@example.com"}]}'

Check Dashboard → Logs — the email should show as [EMAIL_REDACTED].

LiteLLM errors (502 Bad Gateway)​

LiteLLM needs a valid API key for your provider. Edit docker-compose.dev.yml:

litellm:
  environment:
    OPENAI_API_KEY: sk-...

Then: make stop && make dev

In dev, emails are logged to the gateway console:

make logs s=gateway
# Look for: "--- DEV EMAIL ---"

Database connection errors​

make reset

Wipes all volumes and restarts clean. All data will be lost.

Still stuck?​

Open an issue at github.com/autrace/autrace with the output of make logs.