Documentation menu

Error reference

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_REQUIRED

Authentication required

The 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_INVALID

Invalid credentials

The API key or token was rejected.

Fix: Create a fresh key in the dashboard under API keys and update your config.

ERR_VERSION_UNSUPPORTED

Agent version unsupported

This edge no longer supports your agent's protocol version.

Fix: Update the CLI: `trqsh update` or reinstall from the download page.

ERR_QUOTA_TUNNELS

Concurrent tunnel limit reached

Plan limit

You've hit the number of simultaneous tunnels your plan allows.

Fix: Stop an unused tunnel, or upgrade for a higher concurrent limit.

Compare plans
ERR_QUOTA_BANDWIDTH

Bandwidth quota exceeded

Plan limit

This month's transfer allowance is used up.

Fix: Wait for the monthly reset, or upgrade for more bandwidth.

Compare plans
ERR_QUOTA_REQUESTS

Request quota exceeded

Plan limit

This month's request allowance is used up.

Fix: Wait for the monthly reset, or upgrade for a higher request ceiling.

Compare plans
ERR_SUBDOMAIN_TAKEN

Subdomain already taken

Another account has claimed that subdomain.

Fix: Pick a different subdomain, or omit it to get a random one.

ERR_SUBDOMAIN_FORBIDDEN

Subdomain not permitted

Plan limit

Reserved 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 plans
ERR_DOMAIN_UNVERIFIED

Custom domain not verified

The custom domain hasn't completed DNS verification.

Fix: Add the TXT and CNAME records shown in the dashboard, then re-verify.

ERR_PLAN_FORBIDS

Not available on your plan

Plan limit

The 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 plans
ERR_PROTO_UNSUPPORTED

Unsupported protocol

The tunnel protocol you asked for isn't available on this edge.

Fix: Use one of http, https, tls, tcp, or udp.

ERR_PORT_UNAVAILABLE

Remote port unavailable

The requested TCP/UDP remote port is already in use.

Fix: Choose another port, or omit `remote_port` for an ephemeral assignment.

ERR_RATE_LIMITED

Rate limited

Plan limit

You'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 plans
ERR_INTERNAL

Internal error

Something went wrong on the edge.

Fix: Retry shortly. If it persists, check status or contact support.

ERR_UPSTREAM_UNREACHABLE

Local service unreachable

The 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`).