Watchflare docs
Documentation / v0.38.0 / Changelog →

Watchflare documentation

Everything you need to deploy the Hub, enroll your agents and watch your metrics, from a five-minute quickstart to TLS, alerts and package inventory. Open source, self-hosted, a single Go binary.

~5 min

Quickstart in 5 minutes

Deploy the Hub with Docker Compose, create the admin account, enroll your first machine. Five steps, zero optional config.

Start here

Install the agent

Enroll any Linux machine in one command, or use Homebrew on macOS. The agent registers itself, generates its key, and starts reporting in under a minute.

Read guide

Set up alerts

Define CPU, memory, disk, load, and temperature thresholds per host. Get paged when a host crosses a limit or goes offline. Connect a notification channel before a problem becomes an outage.

Read guide

Monitor packages

Track every installed package across your fleet. Watchflare flags outdated packages and pending security updates so you know what needs patching.

Read guide

Architecture & security

The Hub and its agents communicate over gRPC/TLS 1.3 with per-request HMAC auth. Data never leaves your infrastructure. Understand the trust model before going to production.

Read concept

Configuration reference

All Hub environment variables in one place: database, ports, TLS mode, cookie security, gRPC timestamp window, and more.

Read guide

Stack overview

Architecture →
Edge · your infrastructure
gRPC · TLS 1.3 · HMAC-SHA256
SQL · TCP 5432
Storage TimescaleDB Hypertables · Continuous aggregates · Retention
Linked nodes open their reference page.