how-to · A machine 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 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 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.