Skip to main content

expanso-edge

expanso-edge​

Expanso Edge - Autonomous edge computing agent

Synopsis​

Expanso Edge is an autonomous edge computing agent that connects to the Expanso control plane and executes data processing pipelines on your infrastructure.

What Is The Edge Agent?​

The edge agent is a lightweight, autonomous service that: • Connects securely to your managed Expanso control plane • Registers with node identity and capabilities (labels, resources) • Receives job assignments from the control plane • Executes data processing pipelines assigned to the node • Reports execution status and metrics back to the control plane • Maintains itself with minimal human intervention

Getting Started:​

  1. Bootstrap your edge node (one-time setup): expanso-edge bootstrap --token YOUR_BOOTSTRAP_TOKEN

  2. Run the edge agent: expanso-edge run

  3. Verify from CLI that your node is connected: expanso-cli node list

The edge agent will automatically reconnect if the connection is lost and will execute jobs assigned by the control plane based on node selectors.

For complete guides, see the Getting Started section.

Environment:​

EXPANSO_EDGE_API_LISTEN_ADDR (same as --api-listen) EXPANSO_EDGE_BOOTSTRAP_FORCE_IPV4 Force IPv4 during bootstrap (same as --bootstrap-force-ipv4) EXPANSO_EDGE_BOOTSTRAP_INSECURE Skip bootstrap TLS check (dev only) (same as --bootstrap-insecure) EXPANSO_EDGE_BOOTSTRAP_NO_PROXY Bypass proxy during bootstrap (same as --bootstrap-no-proxy) EXPANSO_EDGE_BOOTSTRAP_TOKEN Cloud bootstrap token (same as --bootstrap-token) EXPANSO_EDGE_BOOTSTRAP_URL Bootstrap service URL (advanced) (same as --bootstrap-url) EXPANSO_EDGE_DATA_DIR (same as --data-dir) EXPANSO_EDGE_DNS_SERVERS Comma-separated DNS servers for the Go resolver EXPANSO_EDGE_ENROLL_ORCHESTRATOR Orchestrator URL for v2 direct enrollment (same as --orchestrator) EXPANSO_EDGE_ENROLL_TOKEN Enrollment token for v2 direct enrollment (same as --token) EXPANSO_EDGE_LOCAL_MODE (same as --local) EXPANSO_EDGE_LOG_FORMAT (same as --log-format) EXPANSO_EDGE_LOG_LEVEL (same as --log-level) EXPANSO_EDGE_NAME (same as --name) EXPANSO_EDGE_NAME_PROVIDER (same as --name-provider) EXPANSO_EDGE_STORE_POSTGRES_CONNECTION_STRING
EXPANSO_EDGE_STORE_POSTGRES_PASSWORD
EXPANSO_EDGE_TELEMETRY_AUTHENTICATION_TOKEN
EXPANSO_EDGE_TELEMETRY_ERROR_REPORTING_ENDPOINT
EXPANSO_EDGE_TELEMETRY_HEADERS_<key> Map entry; set one variable per key EXPANSO_PPROF_ADDR pprof/debug HTTP listen address

Prefer these over the equivalent flags for secrets: flag values are visible in ps output and in /proc/<pid>/cmdline on Linux.

Options​

  -h, --help      help for expanso-edge
  -v, --verbose   Enable verbose logging

SEE ALSO​