Bootstrap

expanso-edge bootstrap

Bootstrap your edge node to Expanso Cloud

Synopsis

Bootstrap your edge node to the Expanso control plane.

What Is Bootstrapping?

Bootstrapping is the one-time setup process where your edge node:

1. Contacts the Expanso bootstrap service using your bootstrap token
2. Authenticates and proves authorization to join the control plane
3. Receives unique node credentials and control plane connection details
4. Stores credentials locally in your data directory for future connections

This is a one-time setup. Once bootstrapped, your edge node will automatically connect to the control plane when you run 'expanso-edge run'.

Where To Get Your Token:

1. Log into https://cloud.expanso.io
2. Navigate to Nodes → Add Node
3. Copy your bootstrap token (valid for limited time or single use)

What Happens After Bootstrap:

1. Node credentials are stored in your data directory
2. Run 'expanso-edge run' to start the agent
3. Node automatically connects and registers with the control plane
4. View your node: expanso-cli node list
5. Node is ready to receive job assignments

Security Notes:

• Bootstrap tokens are typically single-use or time-limited • Node credentials are stored securely in your data directory • Use --force to re-bootstrap (invalidates old credentials) • Keep your data directory secure (contains node identity)

Examples:

Bootstrap with token

expanso-edge bootstrap --token "abc123"

Bootstrap with custom URL (self-hosted control plane)

expanso-edge bootstrap --token "abc123" --url "https://bootstrap.mycompany.com"

Force re-bootstrap (get new credentials)

expanso-edge bootstrap --token "abc123" --force

expanso-edge bootstrap [flags]

Options

  -c, --config strings    Paths to configuration files or directories
      --data-dir string   Data directory path
  -f, --force             Force re-bootstrap even if already bootstrapped
  -h, --help              help for bootstrap
  -t, --token string      Bootstrap token from Expanso Cloud
  -u, --url string        Bootstrap service URL (advanced)

Options inherited from parent commands

  -v, --verbose   Enable verbose logging

SEE ALSO

• expanso-edge - Expanso Edge - Autonomous edge computing agent

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