Skip to main content

TailscaleStatus

Snapshot of the local node's Tailscale connectivity state.

All fields except running are None when tailscaled is not running or is not installed.

Attributes: running: True only when tailscaled reports BackendState == "Running". self_ip: The node's Tailscale IPv4 address (100.x.x.x range). None when not running or not assigned. hostname: The node's hostname as registered in the tailnet. dns_name: The node's fully-qualified Tailscale MagicDNS name, e.g. my-node.tailnet-abc.ts.net. Trailing dot stripped. tailnet: The tailnet name derived from dns_name, e.g. tailnet-abc.ts.net. None when dns_name is absent or cannot be parsed. version: The tailscale client version string. peer_ips: The Tailscale IPv4 (100.x) addresses of all other nodes in the tailnet. Used to auto-populate libp2p bootstrap peers so a Tailscale cluster needs no hand-maintained IP list — non-Skulk peers simply fail the private-network handshake and are ignored.

runningRunning (boolean)required

True when tailscaled reports BackendState == 'Running'.

selfIp object

Node's Tailscale IPv4 address (100.x.x.x).

anyOf
string
hostname object

Node hostname in the tailnet.

anyOf
string
dnsName object

Fully-qualified Tailscale MagicDNS name.

anyOf
string
tailnet object

Tailnet name derived from dns_name.

anyOf
string
version object

Tailscale client version string.

anyOf
string
peerIpsstring[]

Tailscale IPv4 addresses (100.x) of other tailnet nodes.

TailscaleStatus
{
  "running": true,
  "selfIp": "string",
  "hostname": "string",
  "dnsName": "string",
  "tailnet": "string",
  "version": "string",
  "peerIps": [
    "string"
  ]
}