Skip to main content

Gotify agent alert notifications

Gotify is a self-hosted push notification service created for sending and receiving messages in real time.

Configuring Gotify


To use Gotify as your notification service, you need an application token. You can generate a new token in the Gotify Web UI.


To set up Gotify in Netdata:

  1. Switch to your config directory and edit the file health_alarm_notify.conf using the edit config script.

    ./edit-config health_alarm_notify.conf
  2. Change the variable GOTIFY_APP_TOKEN to the application token you generated in the Gotify Web UI. Change GOTIFY_APP_URL to point to your Gotify instance.


    # Application token
    # Gotify instance url

    Changes to health_alarm_notify.conf do not require a Netdata restart.

  3. Test your Gotify notifications configuration by running the following commands, replacing ROLE with your preferred role:

    # become user netdata
    sudo su -s /bin/bash netdata

    # send a test alarm
    /usr/libexec/netdata/plugins.d/ test ROLE

    🟢 If everything works, you'll see alarms in Gotify:

    Example alarm notifications in Gotify

    🔴 If sending the test notifications fails, check /var/log/netdata/error.log to find the relevant error message:

    2020-09-03 23:07:00: ERROR: failed to send Gotify notification for: hades test.chart.test_alarm is CRITICAL, with HTTP error code 401.

Was this page helpful?

Need more help?