Monitoring Proxmox backups with healthchecks.io

Posted on Dec. 7, 2025 by Ben Dickson.


A simple setup for notifying Healthchecks.io about backups running.

There seems to be plenty of options for this. There is examples included in Proxmox at /usr/share/doc/pve-manager/examples/vzdump-hook-script.pl but I would like to continue my multi-decade absense from writing Perl. There is also this one which seems well written Python, but requires installing some additional dependenices on each node.

Instead from here the hooks can be written as a fairly reasonable Bash script.

In /etc/vzdump.conf

script: /root/backup-hook.sh

Then create /root/backup-hook.sh and ensure it is chmod +x /root/backup-hook.sh

#!/bin/bash

HC_UUID='put-your-uuid-id-here'

case "$1" in
    job-start)
        curl -m 10 --retry 5 https://hc-ping.com/${HC_UUID}/start
        ;;
    job-end)
        curl -m 10 --retry 5 https://hc-ping.com/${HC_UUID}
        ;;
    job-abort)
        curl -m 10 --retry 5 https://hc-ping.com/${HC_UUID}/fail
        ;;
    backup-abort)
        curl -m 10 --retry 5 https://hc-ping.com/${HC_UUID}/fail
        ;;
esac

(note there was an error in previous version of this, where it used $@ with all arguments instead of $1, and also did not catch backup-abort which occurs when a single backup task fails)

I then created a separate check for each node (e.g proxmox-backup-node1, proxmox-backup-node2 etc)