Get started
BETA
Browse docs
CLI Reference

justtunnel status

Show the active account, plan, and number of active tunnels.

Show which account the CLI is signed in as, what plan it's on, and how many tunnels are currently active server-side.

This is the fastest way to confirm your token is valid and to see whether you're about to hit the per-plan tunnel limit.

Synopsis

justtunnel status [flags]

status takes no arguments.

Examples

Check the active account

justtunnel status
Email:          octocat@example.com
Plan:           free
Active tunnels: 1

The plan field is one of free, pro, team, etc. Active-tunnel count is the live server count, not just what's running on this machine — useful for catching forgotten tunnels on another laptop.

Use status as a CI smoke test

JUSTTUNNEL_AUTH_TOKEN=justtunnel_... justtunnel status

If the token is valid the command exits 0 and prints the account summary. If it's not, you get a clear not authenticated or authentication failed error and a non-zero exit — perfect for a pre-flight check before opening tunnels in a CI job.

Flags

No flags.

status inherits the persistent --config and --context flags from the root command.

Exit codes

CodeMeaning
0Status printed successfully.
1Failure — not authenticated, server unreachable, or the server returned a non-2xx response.

See also

On this page