CLI Reference
Expanso provides command-line tools for managing your edge computing infrastructure.
Available CLIs
- expanso-cli - Command-line interface for interacting with Expanso
- expanso-edge - Edge agent command-line tool
Installation
For installation instructions, see the Getting Started - Installation guide.
How It Works
The Expanso CLI works against Expanso endpoints, which can be either:
- Control plane: The central management service (hosted in Expanso Cloud or your infrastructure)
- Edge nodes: Individual edge agents running on your devices
Your configured profile endpoint determines what you're talking to. Most operations work against both types of endpoints, with output varying based on the target.
Local Mode
Edge nodes can run in "local mode" for standalone operation without a control plane connection. This is useful for:
- Local development and testing
- Troubleshooting specific edge nodes
- Air-gapped or isolated deployments
When an edge node runs in local mode, you can deploy jobs directly to it using the CLI by pointing your profile to the edge node's endpoint.
Getting Started
# Configure your profile to point to the control plane
expanso-cli profile save --name production --endpoint https://demo.us1.cloud.expanso.io:9010
# Check status
expanso-cli status
# List your nodes
expanso-cli node list