how-to · watch Open this in the console

Add a disk or ping check.

Checks are a document the hub pushes to the agent. The agent validates it and evaluates immediately. You are not sending a script.

Ping targets used in checks are also sampled every heartbeat, so you get a chart for free.
01

Open Health › checks

Select the machine, then health › checks. Results are on top. The editor underneath adds to the document; nothing is live until you push.

Machine checks tab with the checks editor
Checks editor on Accounts server. Empty until you add one.
02

Pick a primitive, fill the fields, add to list

Free space on a volume needs a path (C:\ or /) and a minimum free GB. A ping of a gateway or another host is Check that a host answers a ping. A simple HTTP GET is Check that a URL answers. The same editor covers a service, a process, a file or folder, a DNS name, a share, a listening port, a printer, a mapped drive, and someone signed in. A backup file that must have been written recently is Check that a backup file is recent. An HTTP health URL, with a status and a certificate lifetime, is Check that an app answers. A guest on a hypervisor is Check that a virtual machine is running. A Coolify or Compose app is Check that a Docker app is running. A Windows laptop's SSID or signal is Check the Wi-Fi network. A minimum file size is Check that a file is large enough. A Windows registry value is Check a Windows registry value. A check that should only run on weekdays is Only check during working hours. Press add to list, then push to agent (two-step).

Checks editor with a free-space check added to the list
One check on the list, not yet pushed. Push replaces the whole document on the agent.

Push is a two-step button — Push checks to the agent. The agent must be online to evaluate; you can still edit the document while it is offline and it applies at the next hello. Taking one off the list is Remove a check. How often it runs, and whether a failure is info, warn, or crit, is Choose how often a check runs, and how serious it is.