Skip to content
Agirunner

Troubleshooting

Most local problems in Agirunner fall into one of a few buckets: the platform is not reachable, the model layer is not configured, or the runtime cannot claim and execute work correctly.

Common Local Problems

Section titled “Common Local Problems”
  • dashboard or API ports not reachable
  • model provider not configured, so workflows cannot execute
  • Docker, socket, or image issues preventing task execution
  • auth or API key mismatches inside the stack

Good First Checks

Section titled “Good First Checks”
Terminal window
docker compose ps
curl http://localhost:8080/health

Then inspect:

  • the dashboard at http://localhost:3000
  • the login key in agirunner/.env
  • dashboard diagnostics
  • live logs
  • live containers
  • platform and runtime service logs

Practical Rule

Section titled “Practical Rule”

If the dashboard loads but workflows do not move, suspect model configuration, image pull problems, or task execution. If the dashboard does not load, start with the platform and Compose health surfaces.