Run
expanso-edge run
Run the Expanso Edge agent
Synopsis
Run the Expanso Edge agent to connect to the control plane and execute jobs.
What Happens When You Run:
- Agent loads configuration and credentials (from bootstrap)
- Connects to the Expanso control plane
- Registers node with capabilities and labels
- Begins listening for job assignments
- Executes jobs that match the node's selector labels
- Reports execution status and metrics back to the control plane
The agent runs continuously, maintaining connection and executing assigned jobs.
Configuration Reloading:
By default, the agent monitors configuration files and automatically restarts when changes are detected. This allows you to update node labels, resources, or other settings without manual restarts.
Use --no-watch to disable automatic reloading (useful in containerized environments).
Modes:
• Standard mode (default): Connects to control plane using bootstrap credentials • Local mode (--local): Runs standalone without control plane (testing/development)
Monitoring:
Once running, verify your node is connected: expanso-cli node list # See all nodes expanso-cli node describe NODE_ID # View node details expanso-cli execution list --node NODE_ID # See jobs running on node
Prerequisites:
Before running, you must bootstrap your node: expanso-edge bootstrap --token YOUR_BOOTSTRAP_TOKEN
Examples:
Run with config watching (standard)
expanso-edge run
Run without config watching
expanso-edge run --no-watch
Run in local mode (no control plane connection)
expanso-edge run --local
Run with custom config file
expanso-edge run --config /path/to/config.yaml
Run with verbose logging
expanso-edge run --verbose
expanso-edge run [flags]
Options
--api-listen string API listen address
--bootstrap-token string Bootstrap token from Expanso Cloud
--bootstrap-url string Bootstrap service URL (advanced)
-c, --config strings Paths to configuration files or directories
--data-dir string Data directory path
-h, --help help for run
--local Run in local mode (no control plane connection)
--log-format string Log format (json, text, console)
--log-level string Log level (trace, debug, info, warn, error)
--name string Node name (defaults to hostname)
--name-provider string Name provider for auto-generation: cloud, hostname, uuid, machine-id (default: hostname)
--no-watch Disable configuration file watching
--restart-delay duration Delay before restarting service on config change (default 2s)
-v, --verbose Enable verbose logging
SEE ALSO
- expanso-edge - Expanso Edge - Autonomous edge computing agent