Skip to content

📣 Setting Up Gotify Alerts on Proxmox

(Written November 2025)

Abstract

How to setup Gotify notifications in Proxmox using Docker Compose in an LXC container.


Prerequisites


1. Setup Gotify with Docker Compose

For your docker compose setup, use the configuration below:

services:
    gotify:
        image: gotify/server
        ports:
            - 8080:80
        environment:
            GOTIFY_DEFAULTUSER_PASS: 'YourUniquePassword'
        volumes:
            - './gotify_data:/app/data'

2. Configure Gotify

Go to the Gotify dashboard:

https://<IPofGotify>:8080

Login with the admin user and the password that you provided in the yaml config.

Now we need to create an application in Gotify to receive notifications from Proxmox. Do this by going to Apps -> Create Application -> Fill in a name (example 'Proxmox server')
proxmoxgotifynotifications

Copy the token, as we will need it for our conifguration in Proxmox
proxmoxgotifynotifications


3. Configure Proxmox

In the Proxmox dashboard, go to Datacenter -> Notifications -> Add -> Gotify Fill in the details: - Endpoint Name: Give a name (example: "Gotify") - Server URL: Fill in the address of your Gotify server (example "http://:8080) - API token: Fill in the token from the Gotify dashboard

proxmoxgotifynotifications

Modify the Notification matcher so that notifications are being sent to Gotify. Select "default-matcher" -> Targets to notify -> Check gotify

proxmoxgotifynotifications


4. Test Gotify

Select Gotify and click test.
proxmoxgotifynotifications

Go back to the Gotify dashboard and you should receive a notification.
proxmoxgotifynotifications


5. Phone notifications

Gotify has created an app for Android. Iphone user will need to look at an app called Igotify.

Please note that you will need to expose Gotify publicly or via a VPN to receive notifications outside your own private network at home.


6. Proxmox Backup Server

You can also set the notifications in Proxmox Backup Server. The configuration is basicly the same as in Proxmox VE.

proxmoxgotifynotifications