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
| File | What it is | SHA-256 |
|---|---|---|
agent | The installer script, the same one install.constellation.space/agent serves | 1d124c20d7914d3053de6b4996f15b4d005236b6f7129bd6ae3ca8e218381ba2 |
constellation-agent-amd64 | The constellation-agent command, x86_64 | 69f879c7847876b211b223eb636e1fc7a3cfff8b1e41d928e6720ece0f4bfd7b |
constellation-agent-arm64 | The constellation-agent command, aarch64 | 0a771b18bd615469e288d4202e0c07c68ddfa5975b0b6e0eb14bc48c2a026e80 |
telegraf-constellation-grpc-amd64 | The gRPC egress plugin, x86_64. Not needed with CONSTELLATION_EGRESS=http | 20615b3b0bea735a854f6d80369bb3abaf60213deaf22bb9cbebcfddf3ae73c9 |
telegraf-constellation-grpc-arm64 | The gRPC egress plugin, aarch64. Not needed with CONSTELLATION_EGRESS=http | 3c335b1c89bc75c07b534891679d1eef1ee2eeaa84b31c03a7d7872c03cea652 |
LICENSE | The agent's license, Apache 2.0 | cfc7749b96f63bd31c3c42b5c471bf756814053e847c10f3eb003417bc523d30 |
README.md | The agent's readme | 7f5a2d4297e1de690e2e7f4e62c47b8342c5e74f5c22397d32f9ff8765c62829 |
SOCKET_PROTOCOL.md | The socket write contract | 8b0234368e2490438acc72bbce01730b5cbf1efdd7e28cf4634856d33b350895 |
SHA256SUMS | Checksums for every file in the release | |
SHA256SUMS.sigstore.json | The 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:
| Distribution | amd64 | arm64 |
|---|---|---|
| Debian, Ubuntu | telegraf_1.39.2-1_amd64.deb (.asc) | telegraf_1.39.2-1_arm64.deb (.asc) |
| RHEL, Fedora, CentOS, Amazon Linux | telegraf-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.