How to get Duplicati backup jobs notifications with nfty.sh ?

When running automated backups, especially with a tool like Duplicati, it’s important to be notified about their status. Did the backup complete successfully? Was there a warning? Did it fail entirely?

In this post, I’ll walk you through how I integrated Duplicati with a self -hosted ntfy.sh instance to receive push notifications about your backup jobs.

Why ntfy.sh ?

ntfy.sh is a simple publish-subscribe notification service that supports mobile push, desktop notifications, and webhooks. It's perfect for my use case and I find it easy to integrate. You may prefer gotify or pushbullet, I have not tried these I can't tell if they are as good.

The documentation

You will find all related documentation there:

Scripts | Duplicati

Duplicati

The script

Here's the script I created and configured in Duplicati (I was inspired by a blog post here):

#!/bin/bash

# Read Duplicati environment variables
EVENTNAME=$DUPLICATI__EVENTNAME
OPERATIONNAME=$DUPLICATI__OPERATIONNAME
REMOTEURL=$DUPLICATI__REMOTEURL
LOCALPATH=$DUPLICATI__LOCALPATH
BACKUPNAME=$DUPLICATI__backup_name

NTFY_URL="https://ntfy.example.com/duplicati"
NTFY_TOKEN="tk_abcd1234"

if [ "$EVENTNAME" == "BEFORE" ]
then
    # Send start notification
    curl -s -X POST "$NTFY_URL" \
        -H "Authorization: Bearer $NTFY_TOKEN" \
        -H "Title: Duplicati $OPERATIONNAME starting" \
        -H "Priority: low" \
        -d "A $OPERATIONNAME job on '$DUPLICATI__backup_name' is starting."
elif [ "$EVENTNAME" == "AFTER" ]
then
    if [ "$OPERATIONNAME" == "Backup" ]
    then
        if [ "$DUPLICATI__PARSED_RESULT" == "Success" ]
        then
        # Notify success
        curl -s -X POST "$NTFY_URL" \
            -H "Authorization: Bearer $NTFY_TOKEN" \
            -H "Title: Duplicati $OPERATIONNAME finished" \
            -H "Priority: low" \
            -H tags:white_check_mark,tada \
            -d "Backup '$DUPLICATI__backup_name' completed successfully"

        elif [ "$DUPLICATI__PARSED_RESULT" == "Warning" ]
        then
        # Notify warning
        curl -s -X POST "$NTFY_URL" \
            -H "Authorization: Bearer $NTFY_TOKEN" \
            -H "Title: Duplicati $OPERATIONNAME finished" \
            -H "Priority: default" \
            -H tags:warning \
            -d "Backup '$DUPLICATI__backup_name' completed with warnings"
        else
        # Notify failure
        curl -s -X POST "$NTFY_URL" \
            -H "Authorization: Bearer $NTFY_TOKEN" \
            -H "Title: Duplicati $OPERATIONNAME finished" \
            -H "Priority: high" \
            -H tags:x \
            -d "Backup '$DUPLICATI__backup_name' failed with status: $DUPLICATI__PARSED_RESULT"
        fi
    else
		# Send generic notification via ntfy
        curl -s -X POST "$NTFY_URL" \
            -H "Authorization: Bearer $NTFY_TOKEN" \
            -H "Title: Duplicati $OPERATIONNAME finished" \
            -H "Priority: low" \
            -d "A $OPERATIONNAME job on '$DUPLICATI__backup_name' has ended (no information on status)."
    fi
else
	# This should never happen, but there may be new operations
	# in new version of Duplicati
	# We write this to stderr, and it will show up as a warning in the logfile
	echo "Got unknown event \"$EVENTNAME\", ignoring" >&2
fi

exit 0

Integration steps

1. Save this script to your duplicati appdata folder location, e.g., /mnt/user/appdata/duplicati/notification_script/notify.sh
2. Make it executable with chmod : chmod +x /usr/local/bin/duplicati-ntfy-notify.sh
3. Check your docker container can access the /mnt/user/appdata/duplicati folder with path mapping to /config. This is my configuration but you can adapt it if you want.
4. Attach it to your Duplicati job under Run script after (and/or before) backup, using the proper script path.

The result

Launch a backup or a file verification to test the script. You should receive some notification :

Nice, It works ! 😄