Skip to main content

Nodes

expanso-cli node​

Manage nodes

Synopsis​

View and manage edge nodes in your Expanso deployment.

What Is A Node?​

A node is an edge agent (expanso-edge) running on your infrastructure that connects to the control plane. Each node: • Connects securely to the control plane via NATS transport • Reports its identity, labels, and resource capabilities • Executes jobs assigned by the control plane based on selectors • Sends execution status, logs, and metrics • Maintains connection and automatically reconnects if disconnected

Node Lifecycle:​

  1. Bootstrap: Node obtains credentials from bootstrap service (one-time)
  2. Connect: Node establishes secure connection to control plane
  3. Register: Node reports identity, labels, capabilities, and resources
  4. Ready: Node is available to receive job assignments
  5. Execute: Node runs assigned jobs
  6. Disconnect: Connection lost (node shown as "disconnected" until reconnected)

Node Labels:​

Nodes are tagged with labels for targeting: • System labels: region, zone, os, arch • Custom labels: env=production, datacenter=us-west-1 • Used in job selectors to control where jobs run

Node Capabilities:​

Nodes report their capabilities: • Available resources (CPU, memory, disk) • Supported job types • Network connectivity • Storage capabilities

Common Tasks:​

List all connected nodes

expanso-cli node list

Filter by label

expanso-cli node list --label env=production

View detailed node information

expanso-cli node describe node-id-123

See what's running on a node

expanso-cli node executions node-id-123

Check node health and resource usage

expanso-cli node stats

Options​

  -h, --help   help for node

Options inherited from parent commands​

      --auth-token string   API bearer authentication token
  -e, --endpoint string     API endpoint URL
  -k, --insecure            Skip TLS certificate verification
  -p, --profile string      Profile to use for configuration
      --timeout string      Request timeout duration
  -v, --verbose             Enable verbose logging

SEE ALSO​

Auto generated by spf13/cobra on 19-Nov-2025​