Install on Linux

The Collector installs directly onto a Linux host (amd64 or arm64) and runs as a systemd service. This is the default install path.

Before you start

A Linux host with systemd that meets the sizing in Size the host and the network requirements in Network requirements.
Root access (sudo) and curl.
An enrolment token: in the portal, go to Collectors → Add Collector and name the Collector. The portal issues a single-use token and a ready-to-paste install command.

Paste the command from the portal onto your host:

curl -fsSL https://[portal-host]/public/collectors/install.sh \
  | sudo AV_ENROLL_TOKEN=[one-time-token] bash

The installer:

Checks the host for root access, curl and systemd.
Redeems the token with M.A.R.C.U.S. Cloud and receives the Collector’s identity and HMAC key.
Creates a dedicated non-root av-bridge system user.
Installs the Collector binary and writes its configuration.
Registers and starts av-bridge.service, then waits for the local health check to pass.

The Collector then downloads its device list from the cloud automatically. The whole process typically takes under 15 minutes.

Item	Location
Binary	`/usr/local/bin/av-bridge`
Configuration	`/etc/av-bridge/config.yaml` and `/etc/av-bridge/env`
State	`/var/lib/av-bridge/`
Logs	`/var/log/av-bridge/` and the systemd journal
Service	`av-bridge.service`, running as user `av-bridge`

Follow the logs: journalctl -u av-bridge -f