When trqsh declines a request, it returns one of these stable codes. The CLI, desktop app, and dashboard link straight to the matching entry below — so you always know what happened and what to do next.
ERR_AUTH_REQUIREDThe edge received a bind without valid credentials.
Fix: Run `trqsh login`, or set `TRQSH_API_KEY` / the `api_key` field in `~/.trqsh-uz/trqsh.yml`.
ERR_AUTH_INVALIDThe API key or token was rejected.
Fix: Create a fresh key in the dashboard under API keys and update your config.
ERR_VERSION_UNSUPPORTEDThis edge no longer supports your agent's protocol version.
Fix: Update the CLI: `trqsh update` or reinstall from the download page.
ERR_QUOTA_TUNNELSYou've hit the number of simultaneous tunnels your plan allows.
Fix: Stop an unused tunnel, or upgrade for a higher concurrent limit.
Compare plansERR_QUOTA_BANDWIDTHThis month's transfer allowance is used up.
Fix: Wait for the monthly reset, or upgrade for more bandwidth.
Compare plansERR_QUOTA_REQUESTSThis month's request allowance is used up.
Fix: Wait for the monthly reset, or upgrade for a higher request ceiling.
Compare plansERR_SUBDOMAIN_TAKENAnother account has claimed that subdomain.
Fix: Pick a different subdomain, or omit it to get a random one.
ERR_SUBDOMAIN_FORBIDDENReserved subdomains require an entitlement your plan lacks, or you've used them all.
Fix: Reserve the subdomain in the dashboard, or upgrade for more reserved slots.
Compare plansERR_DOMAIN_UNVERIFIEDThe custom domain hasn't completed DNS verification.
Fix: Add the TXT and CNAME records shown in the dashboard, then re-verify.
ERR_PLAN_FORBIDSThe feature you requested (e.g. UDP or TLS tunnels) isn't included in your plan.
Fix: Upgrade to a plan that includes it — the error names the plan required.
Compare plansERR_PROTO_UNSUPPORTEDThe tunnel protocol you asked for isn't available on this edge.
Fix: Use one of http, https, tls, tcp, or udp.
ERR_RATE_LIMITEDYou're opening connections or making requests too quickly.
Fix: Back off and retry; upgrade for a higher rate limit if you hit it often.
Compare plansERR_INTERNALSomething went wrong on the edge.
Fix: Retry shortly. If it persists, check status or contact support.
ERR_UPSTREAM_UNREACHABLEThe edge reached your agent, but the agent couldn't connect to your local service.
Fix: Confirm your local server is running on the address you tunneled (e.g. `localhost:3000`).