Troubleshooting

This usually means the Docker daemon isn't reachable.

1. Open Docker Desktop and wait for the engine to start.
2. Ensure you are in the docker-users group (Windows).
3. Verify WSL2 integration is enabled in Docker Settings > Resources > WSL Integration.

If Docker fails to start on Windows complaining about WSL2:

1. Open PowerShell as Administrator.
2. Run: wsl --update
3. Restart Docker Desktop.

First-time starts may take longer to download large images (2-4GB).

• Check your internet connection speed.
• View logs in the dashboard Quick Launch section or My Agents page.
• If stuck for >10 mins, stop the agent and try again.

Agents may fail if their required ports (e.g., 3000, 8080) are in use.

• Check running processes for port usage.
• Stop other web servers or containers.
• Restart Orrerygen Desktop to clear stale bindings.

Sometimes the local database sync might lag.

• Click the Refresh button on the My Agents page.
• Restart the Orrerygen Desktop application.