Skip to main content

Download the fleet agent

Most hosts never need these files: the install command downloads and verifies them for you. Download them yourself when a host has no route to the internet, or when you mirror releases on your own server.

The current release is 0.1.1, for Linux on amd64 or arm64. Every file below is served from:

https://install.constellation.space/agent/releases/0.1.1/

Release files​

FileWhat it isSHA-256
agentThe installer script, the same one install.constellation.space/agent serves1d124c20d7914d3053de6b4996f15b4d005236b6f7129bd6ae3ca8e218381ba2
constellation-agent-amd64The constellation-agent command, x86_6469f879c7847876b211b223eb636e1fc7a3cfff8b1e41d928e6720ece0f4bfd7b
constellation-agent-arm64The constellation-agent command, aarch640a771b18bd615469e288d4202e0c07c68ddfa5975b0b6e0eb14bc48c2a026e80
telegraf-constellation-grpc-amd64The gRPC egress plugin, x86_64. Not needed with CONSTELLATION_EGRESS=http20615b3b0bea735a854f6d80369bb3abaf60213deaf22bb9cbebcfddf3ae73c9
telegraf-constellation-grpc-arm64The gRPC egress plugin, aarch64. Not needed with CONSTELLATION_EGRESS=http3c335b1c89bc75c07b534891679d1eef1ee2eeaa84b31c03a7d7872c03cea652
LICENSEThe agent's license, Apache 2.0cfc7749b96f63bd31c3c42b5c471bf756814053e847c10f3eb003417bc523d30
README.mdThe agent's readme7f5a2d4297e1de690e2e7f4e62c47b8342c5e74f5c22397d32f9ff8765c62829
SOCKET_PROTOCOL.mdThe socket write contract8b0234368e2490438acc72bbce01730b5cbf1efdd7e28cf4634856d33b350895
SHA256SUMSChecksums for every file in the release
SHA256SUMS.sigstore.jsonThe signature over SHA256SUMS

The installer checks each binary against the checksum built into it, whether it downloaded the file or you supplied it.

Verify the signature​

Releases are signed with a Constellation key. Save its public key as cosign.pub:

-----BEGIN PUBLIC KEY-----
MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEsM9s93JXzUU2vTmF0v7QaPIvDgqe
+myPBoYtnWKHTTVmmEVOrZOBmqVMf/fUcSrB3zq90roE7cosPUUuY9lQjg==
-----END PUBLIC KEY-----

Then check SHA256SUMS with cosign, and the files against it:

cosign verify-blob --key cosign.pub --bundle SHA256SUMS.sigstore.json SHA256SUMS
sha256sum --ignore-missing -c SHA256SUMS

Telegraf​

The agent runs inside Telegraf 1.39.2, which comes from InfluxData. Download the package for your distribution and processor, its .asc signature, and the InfluxData signing key:

Distributionamd64arm64
Debian, Ubuntutelegraf_1.39.2-1_amd64.deb (.asc)telegraf_1.39.2-1_arm64.deb (.asc)
RHEL, Fedora, CentOS, Amazon Linuxtelegraf-1.39.2-1.x86_64.rpm (.asc)telegraf-1.39.2-1.aarch64.rpm (.asc)

Signing key: influxdata-archive.key. Skip Telegraf if the host already runs 1.39.2 from InfluxData's package; if the installer didn't install it, also set CONSTELLATION_ALLOW_TELEGRAF_TAKEOVER=1.

Install on a host with no internet access​

On a machine with access, fetch the files for the target host. This example is a Debian host on amd64 with gRPC egress:

BASE=https://install.constellation.space/agent/releases/0.1.1
mkdir constellation-agent-0.1.1 && cd constellation-agent-0.1.1
curl -fsSLO "$BASE/agent"
curl -fsSLO "$BASE/constellation-agent-amd64"
curl -fsSLO "$BASE/telegraf-constellation-grpc-amd64"
curl -fsSLO "$BASE/SHA256SUMS"
curl -fsSLO "$BASE/SHA256SUMS.sigstore.json"
curl -fsSLO https://dl.influxdata.com/telegraf/releases/telegraf_1.39.2-1_amd64.deb
curl -fsSLO https://dl.influxdata.com/telegraf/releases/telegraf_1.39.2-1_amd64.deb.asc
curl -fsSLO https://repos.influxdata.com/influxdata-archive.key
sha256sum --ignore-missing -c SHA256SUMS

Copy the folder to the host, export CONSTELLATION_API_TOKEN there as in Install the fleet agent, then run the installer from it with every file supplied:

sudo --preserve-env=CONSTELLATION_API_TOKEN env \
CONSTELLATION_CLI_PACKAGE="$PWD/constellation-agent-amd64" \
CONSTELLATION_GRPC_PACKAGE="$PWD/telegraf-constellation-grpc-amd64" \
CONSTELLATION_TELEGRAF_PACKAGE="$PWD/telegraf_1.39.2-1_amd64.deb" \
CONSTELLATION_TELEGRAF_SIGNATURE="$PWD/telegraf_1.39.2-1_amd64.deb.asc" \
CONSTELLATION_INFLUXDATA_KEY="$PWD/influxdata-archive.key" \
sh ./agent

The host still needs outbound access to Constellation ingest to deliver telemetry. A partial set of files fails partway through; see Install-time variables for each one.

Mirror the release​

To serve the files from your own server, copy the release folder as it is and point the installer at it with CONSTELLATION_ARTIFACT_BASE:

sudo --preserve-env=CONSTELLATION_API_TOKEN env \
CONSTELLATION_ARTIFACT_BASE=https://mirror.example.internal/constellation-agent/0.1.1 \
sh ./agent

CONSTELLATION_ARTIFACT_BASE covers the agent binaries only. Telegraf still comes from InfluxData unless you supply it with CONSTELLATION_TELEGRAF_PACKAGE.