/usr/bin/expanso-edge

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.

Usage:
  expanso-edge [command]

Available Commands:
  bootstrap   Bootstrap your edge node to Expanso Cloud
  completion  Generate the autocompletion script for the specified shell
  config      Inspect how expanso-edge is configured
  enroll      Enroll your edge node directly with an orchestrator
  help        Help about any command
  identity    Inspect this edge node's local identity
  run         Run the Expanso Edge agent
  validate    Validate pipeline configs locally
  version     Show version information

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

Use "expanso-edge [command] --help" for more information about a command.