Install

Install Triage from the timmo pacman repository, as a Home Assistant app or container, or from a release.

Triage is a single Linux binary for x86_64 and aarch64. The server also comes as a container image and a Home Assistant app.

Arch Linux

Packages are published to the unofficial timmo pacman repository. Add it before the other repository sections in /etc/pacman.conf:

[timmo]
SigLevel = PackageRequired DatabaseOptional TrustedOnly
Server = https://packages.timmo.dev/$arch

Then install one of the two packages:

Package	Built from
`triage-bin`	The latest release
`triage-git`	Every push to `main`

sudo pacman -Syu triage-bin

Both install the triage command, shell completions and three user services: triage-agent.service, triage-server.service and triage-worker.service. None is enabled on install, since each machine takes on different roles. On upgrade, the package restarts the ones that are running.

Home Assistant

The Home Assistant app runs the server on Home Assistant OS, for amd64 and aarch64. Add this repository to the app store:

then install Triage, set its admin token and start it. See Run a server.

Container

ghcr.io/timmo001/triage runs the server, for amd64 and arm64. See Run a server.

Debian, Ubuntu and Fedora

Each GitHub release has .deb and .rpm packages:

# Debian and Ubuntu
sudo apt install ./triage_<version>_amd64.deb

# Fedora
sudo dnf install ./triage-<version>-1.x86_64.rpm

Release archive

Each release also has a triage-<version>-linux-<arch>.tar.gz archive with just the binary. Put it somewhere on your PATH:

tar -xzf triage-<version>-linux-x86_64.tar.gz
install -Dm755 triage ~/.local/bin/triage

Release assets come with a SHA256SUMS file and a Sigstore bundle. To check an asset was built by this repository’s release workflow:

gh attestation verify triage-<version>-linux-x86_64.tar.gz --repo timmo001/triage

Build from source

You need mise, which installs the pinned Bun and Node versions:

git clone https://github.com/timmo001/triage.git
cd triage
mise install
mise run build

The binary is written to dist/triage.

Next steps

Run a server.
Add the machines to collect from.