How to Self-Host Gotify for Server Notifications

What Is Gotify?

Gotify is a self-hosted push notification server written in Go. It provides a simple REST API for sending messages and a real-time WebSocket interface for receiving them. A companion Android app and web UI make it easy to monitor notifications from your infrastructure.

Prerequisites

• A Breeze running Ubuntu 22.04 or later
• Docker and Docker Compose installed
• A domain name pointed to your Breeze

Docker Compose Setup

mkdir -p ~/gotify && cd ~/gotify

version: "3.8"
services:
  gotify:
    image: gotify/server:latest
    container_name: gotify
    restart: unless-stopped
    ports:
      - "8080:80"
    volumes:
      - gotify_data:/app/data
    environment:
      - GOTIFY_DEFAULTUSER_NAME=admin
      - GOTIFY_DEFAULTUSER_PASS=ChangeThisPassword

volumes:
  gotify_data:

Launch and Configure

docker compose up -d

Open http://your-breeze-ip:8080 and log in with the admin credentials. Go to Apps and create an application token. Use this token to send messages via the API:

curl -X POST "https://gotify.yourdomain.com/message?token=YOUR_APP_TOKEN" \
  -F "title=Backup Complete" \
  -F "message=Daily backup finished successfully." \
  -F "priority=5"

Integration Ideas

• Add API calls to your backup scripts for completion alerts
• Monitor disk usage and send warnings when thresholds are exceeded
• Integrate with monitoring tools like Prometheus via Alertmanager webhooks
• Use client tokens for the Android app to receive real-time notifications