Install the fleet agent
The fleet agent runs on gateways and ground sites: pull topology, push telemetry, and share configuration with ground software.
Install
curl -fsSL "https://console.constellation.space/app/integrations/install.sh" | bash -s -- \
--script-url "https://console.constellation.space/app/integrations/install.sh"
Installs fleet-agent.mjs under ~/.constellation/ (override with CONSTELLATION_CONFIG_DIR).
Configure
export CONSTELLATION_API_TOKEN=cos_live_your_token_here
node ~/.constellation/fleet-agent.mjs configure --config-dir ~/.constellation
Writes config.toml with API endpoints and telemetry routing for your console environment.
Commands
# Fleet graph snapshot
node ~/.constellation/fleet-agent.mjs topology pull --out topology.json
# Push line protocol from stdin
cat metrics.lp | node ~/.constellation/fleet-agent.mjs telemetry post
# Push from file
node ~/.constellation/fleet-agent.mjs telemetry post --file metrics.lp
Environment variables
| Variable | Purpose |
|---|---|
CONSTELLATION_API_TOKEN | Required |
CONSTELLATION_CONFIG_DIR | Optional config directory |