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 "$@" 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)
        ## Healthchecks
        curl -m 10 --retry 5 https://hc-ping.com/${HC_UUID}/fail
        ;;
esac

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