Reference · Error codes

HSX_E_CLOUDFLARED_TIMEOUT

cloudflared did not report a tunnel URL in time.

What this error means

Timed out waiting for the auto-managed Cloudflare quick tunnel to come up.

When this error stops a command, hs-x exits with code 50. With --json, the failure is reported as a structured error whose code field is HSX_E_CLOUDFLARED_TIMEOUT — stable to match on in scripts and agents.

Likely causes

  • Slow network
  • cloudflared stuck in a retry loop

How to fix it

  • Retry the command
  • Run cloudflared tunnel --url http://localhost:9099 manually to diagnose

Still stuck? Re-run the command with --debug for the wire-level detail, or hs-x doctor to check accounts, link state, and connectivity in one pass.

Keep going