NodeState enum

The node's position in the connection lifecycle. Mirrors Go's ipn.State.

Inheritance
Available extensions

Values

noState → const NodeState

No authenticated logical state while the engine is idle.

A persistent Tailscale.up may proceed without an auth key and let upstream return needsLogin for interactive enrollment. Ephemeral mode requires an auth key because it retains no local identity.

needsLogin → const NodeState

The node needs authentication. Open TailscaleStatus.authUrl in a browser / web view to complete the login flow.

needsMachineAuth → const NodeState

The node is authenticated but waiting for admin approval on the control plane. See tailscale.com/kb/1099/device-approval.

starting → const NodeState

The node is connecting to the tailnet (WireGuard tunnel coming up).

running → const NodeState

The node is connected and ready to send/receive traffic.

stopped → const NodeState

The engine is not running and an authenticated persistent StateStore contains logical Tailscale state.

This does not prove that control-plane credentials are still valid. Call Tailscale.up to determine the current upstream state.

unknown → const NodeState

A lifecycle state added by a newer upstream Tailscale runtime that this package does not yet recognize.

Properties

hashCode int
The hash code for this object.
no setterinherited
index int
A numeric identifier for the enumerated value.
no setterinherited
name String

Available on Enum, provided by the EnumName extension

The name of the enum value.
no setter
runtimeType Type
A representation of the runtime type of the object.
no setterinherited

Methods

noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
toString() String
A string representation of this object.
inherited

Operators

operator ==(Object other) bool
The equality operator.
inherited

Static Methods

parse(String? s) NodeState
Parses a Go ipn.State string into a NodeState.

Constants

values → const List<NodeState>
A constant List of the values in this enum, in order of their declaration.