Skip to main content
General·HTTP 503·API, CLI

Tunnel unavailable

tunnel_unavailable

This database doesn't accept tunnel connections yet. Turn on public access and allow your IP address, then try again.

What this means​

Tunnels to this database go through its public endpoint, and its public access is off or doesn't allow any address yet.

How to fix it​

Turn on the database's public access and add your IP address to its allowlist, then open the tunnel again.

Retry behavior​

Retry after turning on public access.

How it appears in the response​

ComputeSphere returns errors as RFC 7807 Problem Details. The type field is the docs URL for this page — switch on code in your client.

{
  "type":    "https://docs.computesphere.com/errors/tunnel_unavailable",
  "title":   "Tunnel unavailable",
  "status":  503,
  "code":    "tunnel_unavailable",
  "detail":  "This database doesn't accept tunnel connections yet. Turn on public access and allow your IP address, then try again.",
  "instance": "/v2/…",
  "request_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "trace_id":   null,
  "retry_after_seconds": 60
}

The Content-Type header is application/problem+json. On field-level validation errors a non-empty errors[] array also appears, each entry carrying its own docs_url for the offending field.