Skip to main content
If Cyrus isn’t behaving as expected, this page covers the most common causes.

Configuration Changes Not Applying

Self-host Runtime
  • Ensure the cyrus process is running locally
  • Restart if necessary
Cloud Runtime
  • Changes apply immediately
  • Refresh the dashboard to confirm

Cloudflare tunnel timed out

If you see “Timeout waiting for Cloudflare tunnel”, there is a networking configuration issue on your server preventing the Cyrus cloudflare tunnel from connecting. Navigate to this Cloudflare networking documentation page to troubleshoot. Screenshot2026 01 21at11 08 38AM 1

Repository Not Processing Issues

Check the following:
  1. Repository is marked Active
  2. Issue belongs to a selected Linear team
  3. Required routing labels are present
  4. Cyrus is assigned to the issue
  5. Integrations are connected
Most issues are caused by routing mismatches.

API Key Problems

If Cyrus fails to start work:
  • Confirm your Claude API key is valid
  • Ensure sufficient credits
  • Verify the key hasn’t been rotated or revoked
Update keys at: https://app.atcyrus.com/settings

Still Stuck?

We’re happy to help.
If troubleshooting reveals a pattern, let us know — it helps improve Cyrus for everyone. cyrus-f1

Cyrus Community

Get real time support on Discord