Telflo
Fleet management

Install collectors

Deploy a fleet's supervisor bundle to bring collectors online.

You install collectors using a fleet's supervisor bundle. The bundle is preconfigured with the fleet's OpAMP endpoint and install token, so a collector installed from it connects to the right fleet.

Collectors install on Linux arm64.

Open the deploy dialog

Open the fleet and select Deploy. The Deploy supervisor bundle dialog opens. Select a platform:

PlatformUse for
Linux arm64 Docker: All In OneRun the collector as a Docker container.
Linux arm64 Server: All In OneInstall on a Linux host.
Linux arm64 ServerInstall on a Linux host.
Linux arm64 Server: Import ConfigurationAdopt an existing collector's configuration.

For Docker platforms, you can set Port mappings (optional): comma-separated host:container pairs, such as 4318:4318, 27018:27018. Each adds an EXPOSE line in the Dockerfile and a -p flag on docker run.

The dialog offers two ways to install: Quick Deploy and Download.

The supervisor bundle and the Quick Deploy URL both contain the fleet's install token, which is a credential. Share them over a secure channel, keep them out of shared logs, and rotate the token if one leaks.

Quick Deploy

Quick Deploy generates a single command you paste on the target host. It downloads, extracts, and runs the supervisor in one step:

sudo bash -c 'set -e; set -o pipefail; D=$(mktemp -d); cd "$D"; \
  curl -fsSL "https://telflo.com/api/v1/quick-deploy/<id>" | tar -xz; \
  docker build -t telflo-supervisor .; \
  docker rm -f telflo-supervisor 2>/dev/null || true; \
  docker run -d --name telflo-supervisor telflo-supervisor'

The Quick Deploy URL expires. Copy the exact command Telflo generates for your fleet.

Download

Download generates a zip with the minimal set of files to run the collector and a README. The Docker bundle includes a Dockerfile and the supporting files. Unzip it, then build and run the image:

docker build -t telflo-supervisor .
docker run telflo-supervisor

Follow the README in the bundle for the exact steps.

After installation

A collector connects to Telflo and appears as an instance on the fleet's detail page, usually within a minute. It pulls its assigned configuration and applies it. Track its progress on the fleet detail page.

On this page