Skip to main content

CLI Commands

Deploy, monitor, and manage jobs running on your local edge node.

Configure CLI for Local Edge​

Set the environment variable to point all CLI commands to your local edge:

export EXPANSO_CLI_ENDPOINT=http://localhost:9010

Tip: Add this to your ~/.bashrc or ~/.zshrc for persistent configuration.

Job Commands​

Deploy a Job​

expanso-cli job deploy my-pipeline.yaml

Alternative: Use --endpoint flag for one-off commands:

expanso-cli job deploy my-pipeline.yaml --endpoint http://localhost:9010

List Running Jobs​

expanso-cli job list

Get Job Status​

expanso-cli job describe <job-id>

Stop a Job​

expanso-cli job stop <job-id>

View Job Executions​

expanso-cli job executions <job-id>

Configuration Options​

Custom API Port​

Local mode listens on port 9010 by default. To change it:

expanso-edge run --local --api-listen :8080

Then update your environment variable:

export EXPANSO_CLI_ENDPOINT=http://localhost:8080

Data Directory​

Specify a custom location for local state:

expanso-edge run --local --data-dir ./my-data

Debug Logging​

Enable detailed execution logs:

expanso-edge run --local --log-level debug

Next Steps​