Alertmanager-Gotify Webhook 🔔

A lightweight Prometheus Alertmanager webhook that forwards alerts to Gotify - perfect for homelabs, self-hosted setups, and production environments.

🚀 Features

• Instant Push Notifications: Get Alertmanager alerts delivered to Gotify on any device
• Simple Configuration: Just set your Gotify URL and token
• Docker-Friendly: Ready-to-run container image
• Templating Support: Customize alert formats with Go templates
• Lightweight: Low resource usage (~10MB Docker image)

📦 Installation

Docker (Recommended)

---
services:
 alertmanager-gotify:
  image: docker.io/${GROUP:-mardinlimunir}/${PROJECT:-alertmanager-gotify}:${TAG:-latest}
  container_name: alertmanager-gotify
  hostname: alertmanager-gotify
  restart: always
  ports:
   - ${GOTIFY_PORT:-9094}:9094
  volumes:
   - type: bind
     source: /etc/localtime
     target: /etc/localtime
     read_only: true
  environment:
   GOTIFY_ALERT_URL: ${GOTIFY_ALERT_URL?:App Token is missing}
   GOTIFY_PORT: ${GOTIFY_PORT:-9094}
   UID: ${UID_NAS_ADMIN:-1026} #optional
   GID: ${GID_NAS_ADMIN:-100} #optional
  networks:
   dockerization:
  labels:
   com.centurylinklabs.watchtower.enable: true

networks:
 dockerization:
  external: true

Copy

🚀 Starting

1. Change to the Docker folder:

cd alertmanager-gotify
Copy

2. Start the desired compose stack:

docker-compose -f server.yml up -d
Copy

⚙️ Configuration

Core Environment Variables

Operational Variables

Configuration Example

1. Create .env file:

    GOTIFY_ALERT_URL=http://gotify/message?token=
    GOTIFY_PORT=4000
    NODE_ENV=production
   Copy

Alertmanager Integration

# alertmanager.yml
receivers:
  - name: 'gotify-alerts'
    webhook_configs:
      - url: 'http://alertmanager-gotify:8080'
        send_resolved: true
route:
  receiver: 'gotify-alerts'
Copy