Skip to main content

Norns

Troubleshooting the Norns agent stack.

Symptoms​

  • API returns 5xx or timeouts
  • Tool calls failing
  • No traces in Langfuse

Checks​

# Container status
ssh ravenhelm@100.115.101.81 "docker ps | grep norns"

# Logs
ssh ravenhelm@100.115.101.81 "docker logs norns-agent --tail 200"

Common Fixes​

  • Verify database connectivity (Postgres + Redis).
  • Ensure Langfuse keys are set in ~/ravenhelm/secrets/.env.
  • Restart the service if dependency outages occurred:
ssh ravenhelm@100.115.101.81 "docker restart norns-agent"