ntfy-bridge

Hub central de notifications pour homelab — agrège des sources multiples (Gitea, Docker, Uptime Kuma, health checks HTTP, scripts cron) et les transforme en notifications Ntfy intelligentes, formatées, avec priorités et contexte.

┌─────────────────┐
│  Gitea webhook  │──┐
├─────────────────┤  │
│  Uptime Kuma    │──┤
├─────────────────┤  │     ┌──────────────┐      ┌───────────┐      ┌──────────────┐
│  Docker events  │──┤────→│  ntfy-bridge │─────→│ Ntfy Srv  │─────→│   Ton phone  │
├─────────────────┤  │     └──────────────┘      └───────────┘      └──────────────┘
│  HTTP health    │──┤
├─────────────────┤  │
│  Scripts cron   │──┘
└─────────────────┘

Pourquoi ntfy-bridge ?

Dans un homelab avec 8+ hôtes Docker, Gitea, Uptime Kuma et des dizaines de services, les alertes arrivent de partout. ntfy-bridge centralise tout dans une seule file de notifications intelligentes — avec le bon niveau de priorité, le bon format, et le bon topic Ntfy.

Sans ntfy-bridge	Avec ntfy-bridge
Webhook Gitea → email (noyé)	Push = notif Ntfy formatée avec auteur, commit, message
Uptime Kuma → alerte brute	"🚨 Gitea DOWN — 503 — since 14:32" avec priority=5
Container qui crashe → logs Docker	"🐳 flowdeck exited OOMKilled on docker-prod-1"
Script cron → email perdu	Résumé quotidien disque à 9h dans ta poche

Installation

Les binaires pré-compilés sont disponibles sur le dépôt Nexus :

https://nexus.dracodev.net/repository/raw-hosted/ntfy-bridge/{VERSION}/

Remplacer {VERSION} par la version souhaitée (ex: v0.7.0).
Chaque release contient trois binaires statiques — zéro dépendance :

Fichier	Plateforme
ntfy-bridge-linux-x86_64	Linux 64-bit (Intel/AMD)
ntfy-bridge-linux-arm64	Linux ARM64 (Raspberry Pi 3/4/5)
ntfy-bridge-windows-x86_64.exe	Windows 64-bit

💡 Pas besoin de V, Git, ni compilateur. Les binaires sont compilés statiquement — un seul fichier, prêt à exécuter.

---

Linux (x86_64)

Option A : Service système (recommandé)

# 1. Télécharger le binaire (remplacer v0.7.0 par la version désirée)
sudo curl -fsSL -o /usr/local/bin/ntfy-bridge \
  https://nexus.dracodev.net/repository/raw-hosted/ntfy-bridge/v0.7.0/ntfy-bridge-linux-x86_64
sudo chmod +x /usr/local/bin/ntfy-bridge

# 2. Créer le répertoire de config et copier l'exemple
sudo mkdir -p /etc/ntfy-bridge
sudo curl -fsSL -o /etc/ntfy-bridge/ntfy-bridge.yaml \
  https://nexus.dracodev.net/repository/raw-hosted/ntfy-bridge/v0.7.0/ntfy-bridge.example.yaml
sudo curl -fsSL -o /etc/ntfy-bridge/dashboard.html \
  https://nexus.dracodev.net/repository/raw-hosted/ntfy-bridge/v0.7.0/dashboard.html

# 3. Éditer la configuration
sudo vim /etc/ntfy-bridge/ntfy-bridge.yaml

# 4. Installer comme service systemd (ou openrc si détecté)
sudo ntfy-bridge --install-service --config /etc/ntfy-bridge/ntfy-bridge.yaml

# 5. Vérifier
curl http://localhost:9090/health

Commandes utiles :

systemctl status ntfy-bridge     # État du service
systemctl restart ntfy-bridge    # Redémarrer après modif de config
journalctl -u ntfy-bridge -f     # Logs en temps réel
ntfy-bridge --uninstall-service  # Désinstaller le service

Option B : Docker

# 1. Créer un dossier et générer la stack docker-compose
mkdir -p /opt/ntfy-bridge && cd /opt/ntfy-bridge
ntfy-bridge --install-docker .

# 2. Éditer la configuration
vim ntfy-bridge.yaml

# 3. Démarrer
docker compose up -d

# 4. Vérifier
curl http://localhost:9090/health

Ce que contient la stack Docker :

• Le binaire exposé sur 127.0.0.1:9090
• ntfy-bridge.yaml monté en read-only dans /etc/ntfy-bridge/
• dashboard.html monté automatiquement
• Variables d'environnement NTFY_TOKEN et NTFY_HMAC_SECRET
• Healthcheck intégré (/health toutes les 30s)
• Redémarrage automatique (restart: unless-stopped)

---

Raspberry Pi (ARM64)

Mêmes étapes que Linux, avec le binaire linux-arm64 :

# 1. Télécharger le binaire ARM64
sudo curl -fsSL -o /usr/local/bin/ntfy-bridge \
  https://nexus.dracodev.net/repository/raw-hosted/ntfy-bridge/v0.7.0/ntfy-bridge-linux-arm64
sudo chmod +x /usr/local/bin/ntfy-bridge

# 2. Récupérer la config et le dashboard
sudo mkdir -p /etc/ntfy-bridge
sudo curl -fsSL -o /etc/ntfy-bridge/ntfy-bridge.yaml \
  https://nexus.dracodev.net/repository/raw-hosted/ntfy-bridge/v0.7.0/ntfy-bridge.example.yaml
sudo curl -fsSL -o /etc/ntfy-bridge/dashboard.html \
  https://nexus.dracodev.net/repository/raw-hosted/ntfy-bridge/v0.7.0/dashboard.html

# 3. Éditer la config
sudo vim /etc/ntfy-bridge/ntfy-bridge.yaml

# 4. Installer le service
sudo ntfy-bridge --install-service --config /etc/ntfy-bridge/ntfy-bridge.yaml

# 5. Vérifier
curl http://localhost:9090/health

Docker sur Raspberry Pi : identique à l'option B Linux — le binaire est déjà dans l'image Docker, pas besoin de le télécharger séparément. Utiliser ntfy-bridge --install-docker . pour générer la stack.

---

Windows

# 1. Créer le dossier d'installation (PowerShell administrateur)
New-Item -ItemType Directory -Force -Path "$env:ProgramFiles\ntfy-bridge"

# 2. Télécharger le binaire Windows
Invoke-WebRequest -Uri "https://nexus.dracodev.net/repository/raw-hosted/ntfy-bridge/v0.7.0/ntfy-bridge-windows-x86_64.exe" `
  -OutFile "$env:ProgramFiles\ntfy-bridge\ntfy-bridge.exe"

# 3. Télécharger la config et le dashboard
Invoke-WebRequest -Uri "https://nexus.dracodev.net/repository/raw-hosted/ntfy-bridge/v0.7.0/ntfy-bridge.example.yaml" `
  -OutFile "$env:ProgramFiles\ntfy-bridge\ntfy-bridge.yaml"
Invoke-WebRequest -Uri "https://nexus.dracodev.net/repository/raw-hosted/ntfy-bridge/v0.7.0/dashboard.html" `
  -OutFile "$env:ProgramFiles\ntfy-bridge\dashboard.html"

# 4. Éditer la configuration (dans le Bloc-notes)
notepad "$env:ProgramFiles\ntfy-bridge\ntfy-bridge.yaml"

# 5. Installer NSSM (requis pour le service Windows)
#    Télécharger depuis https://nssm.cc/download
#    ou avec scoop :  scoop install nssm
#    Placer nssm.exe dans le PATH ou dans $env:ProgramFiles\ntfy-bridge\

# 6. Installer comme service Windows
& "$env:ProgramFiles\ntfy-bridge\ntfy-bridge.exe" --install-service `
  --config "$env:ProgramFiles\ntfy-bridge\ntfy-bridge.yaml"

# 7. Vérifier
Invoke-WebRequest -Uri http://localhost:9090/health

Commandes utiles (PowerShell) :

nssm status ntfy-bridge          # État du service
nssm restart ntfy-bridge         # Redémarrer
nssm stop ntfy-bridge            # Arrêter
nssm start ntfy-bridge           # Démarrer
nssm remove ntfy-bridge confirm  # Désinstaller le service

Logs du service : C:\ProgramData\ntfy-bridge\service.log

---

Mise à jour

Pour mettre à jour vers une nouvelle version, remplacer le binaire et redémarrer :

# Linux / Raspberry Pi
sudo curl -fsSL -o /usr/local/bin/ntfy-bridge \
  https://nexus.dracodev.net/repository/raw-hosted/ntfy-bridge/v0.8.0/ntfy-bridge-linux-x86_64
sudo chmod +x /usr/local/bin/ntfy-bridge
sudo systemctl restart ntfy-bridge

# Windows (PowerShell administrateur)
nssm stop ntfy-bridge
Invoke-WebRequest -Uri "https://nexus.dracodev.net/repository/raw-hosted/ntfy-bridge/v0.8.0/ntfy-bridge-windows-x86_64.exe" `
  -OutFile "$env:ProgramFiles\ntfy-bridge\ntfy-bridge.exe"
nssm start ntfy-bridge

Sources supportées

Source	Type	Description
Gitea	Webhook	Push, PR, issues, releases → notifs formatées
Uptime Kuma	Webhook	Statut up/down avec priorité critique
Docker	Socket	Container start/die/oom/health_status
HTTP Poll	Polling	Health checks périodiques
Cron	Webhook	Reçoit des notifs depuis des scripts shell
Generic	Webhook	Endpoint passe-partout pour tout script custom
Plugin	Exec	Exécutable externe appelé périodiquement (bash, python, …)

Features

• ACLs — Restriction par IP (CIDR) ou Bearer token sur chaque webhook
• Plugins — Scripts externes exécutés toutes les 60s, contrat JSON stdout
• Dashboard — Interface web avec stats, statuts, historique temps réel
• Filtres — Règles conditionnelles drop/set_priority/add_tag par source
• Actions Ntfy — Boutons click, vues, broadcast intégrés
• Prometheus — Endpoint /metrics pour Grafana
• Outgoing webhooks — Forward vers Slack, Discord, JSON
• Silence rules — Mute temporaire des notifs via API
• Grouping — Regroupement intelligent des notifs identiques
• State persistence — Sauvegarde de l'état up/down et silence sur disque

Exemple de config minimale

server:
  url: https://ntfy.dracodev.net
  listen: ":9090"

sources:
  gitea:
    - webhook_path: /webhooks/gitea
      topic: dev-notifs

Licence

MIT