Auto-héberger ntfy pour les alertes push serveur
Déployez ntfy sur un VPS avec TLS et Docker Compose, protégez les topics par utilisateurs et ACL, puis envoyez des alertes depuis cron et systemd OnFailure.
Ce que fait un serveur ntfy auto-hébergé
Un serveur ntfy auto-hébergé transforme une requête HTTP POST en notification push sur votre téléphone. Vous publiez avec curl, puis le message arrive dans l’application Android, l’application iOS, un onglet de navigateur ou tout autre client capable de maintenir une connexion HTTP ouverte. Vous n’avez pas besoin d’installer de bibliothèque cliente ni d’exécuter de message broker.
ntfy adresse les messages par topic. Un topic est un nom placé dans le chemin de l’URL, comme https://ntfy.example.com/alerts, et il existe dès qu’un utilisateur y publie un message. Avec l’installation par défaut, toute personne qui connaît ce nom peut lire le topic et y publier des messages. C’est pourquoi la documentation du projet compare le nom d’un topic à un mot de passe. Ce modèle convient au service public ntfy.sh. Il ne convient pas à un serveur qui transporte les échecs de vos sauvegardes. Ce guide active donc l’authentification avant l’envoi du premier message.
Ce dont vous avez besoin avant de commencer
Vous avez besoin d’un VPS sous Ubuntu 24.04 ou Debian 13, avec Docker Engine et le plugin Compose, d’un nom de domaine et de très peu de RAM. Créez un enregistrement A DNS (domain name system) qui pointe ntfy.example.com vers l’adresse IP publique du serveur, puis vérifiez sa résolution avant toute autre opération.
dig +short ntfy.example.com
sudo ufw allow 80,443/tcp
sudo ufw statusdig doit afficher l’adresse IP de votre serveur. Pour émettre le certificat, le nom d’hôte doit être résolu publiquement vers le serveur au moyen d’un enregistrement A ou AAAA. Le port 80 reste ouvert, car ACME (automatic certificate management environment), le protocole utilisé par Let’s Encrypt, s’en sert pour le challenge HTTP. Le conteneur ntfy, lui, n’expose jamais de port public.
Créer le fichier de configuration de ntfy
L’image Docker ne contient pas de fichier de configuration. Vous devez donc en créer un. Toutes les commandes suivantes de ce guide le liront. Commencez par trouver l’ID utilisateur et l’ID de groupe sous lesquels le conteneur s’exécutera.
id -u
id -g
sudo install -d -o "$(id -u)" -g "$(id -g)" /etc/ntfy /var/cache/ntfy /var/lib/ntfy
sudo nano /etc/ntfy/server.ymlbase-url: "https://ntfy.example.com"
listen-http: ":2586"
behind-proxy: true
cache-file: "/var/cache/ntfy/cache.db"
cache-duration: "12h"
auth-file: "/var/lib/ntfy/user.db"
auth-default-access: "deny-all"
enable-login: true
enable-signup: falseQuatre de ces lignes sont essentielles. base-url doit être l’adresse HTTPS publique exacte, car ntfy l’utilise pour générer les liens vers les pièces jointes et les notifications push iOS auto-hébergées. listen-http: ":2586" écoute sur toutes les interfaces du conteneur. Cela peut sembler imprudent, mais c’est le bon choix : le conteneur possède son propre espace de noms réseau. Si vous le liez à 127.0.0.1, le port serait inaccessible depuis l’hôte et le port publié par Docker ne pourrait jamais établir la connexion. auth-default-access: "deny-all" définit entièrement la politique de sécurité : la lecture et l’écriture sont refusées à toute personne ne disposant pas d’une autorisation explicite. behind-proxy: true indique à ntfy de récupérer l’adresse du client dans l’en-tête X-Forwarded-For. Les limites de débit comptent ainsi les visiteurs réels, au lieu de considérer le reverse proxy comme un client unique particulièrement actif.
enable-login: true permet aux utilisateurs de se connecter via l’application web ou l’API. enable-signup reste défini sur false, car autoriser la création autonome de comptes sur un serveur privé revient à laisser une porte ouverte sans raison.
sudo chown "$(id -u):$(id -g)" /etc/ntfy/server.yml
sudo chmod 600 /etc/ntfy/server.ymlExécuter ntfy avec Docker Compose
Placez ceci dans /opt/ntfy/compose.yaml, en remplaçant 1000:1000 par les deux nombres id -u et id -g affichés plus haut.
services:
ntfy:
image: binwiederhier/ntfy:v2.36.0
container_name: ntfy
command: serve
user: "1000:1000"
environment:
- TZ=UTC
volumes:
- /etc/ntfy:/etc/ntfy
- /var/cache/ntfy:/var/cache/ntfy
- /var/lib/ntfy:/var/lib/ntfy
ports:
- "127.0.0.1:2586:2586"
restart: unless-stoppedcd /opt/ntfy
sudo docker compose up -d
sudo docker compose logs ntfy
curl -s http://127.0.0.1:2586/v1/healthUn serveur sain répond à {"healthy":true,"role":"active"}. Deux détails de ce fichier Compose sont intentionnels. L’image est épinglée sur v2.36.0, la version stable actuelle au 1er novembre 2026, plutôt que sur latest. Avec latest, le prochain docker compose pull télécharge l’image actuelle, puis un docker compose up -d recrée le conteneur avec cette image. Le simple téléchargement ne modifie pas la version du serveur en cours d’exécution. Une version épinglée doit tout de même être mise à jour. Le seul mois d’octobre 2026 a compté dix releases : v2.29.0 le 7 octobre, v2.30.0 le 12 octobre, v2.31.0 et v2.31.1 le 16 octobre, v2.32.0 le 18 octobre, v2.33.0 et v2.33.1 le 23 octobre, v2.34.0 le 24 octobre, v2.35.0 le 30 octobre et v2.36.0 le 31 octobre. v2.31.0 corrige la perte de messages lorsqu’un client se reconnectait avant leur arrivée dans le cache de messages, mais ses reconnexions avec since=<message ID> lisaient chaque message du topic dans la base de données, et ntfy.sh a effectué un rollback. v2.31.1 corrige cette charge avec un nouvel index, et v2.34.0 corrige le problème de comptes révoqués ou supprimés qui conservaient certains abonnements. v2.35.0 corrige les requêtes concurrentes qui traitaient des identifiants valides comme anonymes, ainsi qu’un contournement de l’autorisation de la passerelle push Matrix sur SQLite. Remplacez donc les anciennes versions épinglées par v2.36.0. Le port est publié comme 127.0.0.1:2586:2586, de sorte que le conteneur n’est accessible que depuis l’adresse loopback de l’hôte. Écrivez plutôt 2586:2586 : Docker place alors ses propres règles de firewall avant les vôtres, ce qui rend le port accessible depuis Internet même si ufw status indique qu’il est fermé. Ces deux pratiques s’appliquent aussi au prochain conteneur que vous ajouterez : un relais RustDesk auto-hébergé épingle son tag d’image de la même façon, mais il ne peut pas se limiter à loopback, car ses ports de signalisation et de relais doivent être accessibles depuis Internet.
Si curl affiche Connection refused, consultez le log du conteneur. Une erreur de permission sur /var/lib/ntfy/user.db signifie que la ligne user: ne correspond pas au propriétaire de ces répertoires. Le processus ne peut donc pas créer sa propre base de données et se termine. Le guide des bases de Docker Compose pour un VPS explique plus en détail la propriété des volumes et les politiques de redémarrage.
Placer TLS devant avec Caddy
Caddy demande et renouvelle lui-même le certificat. C’est la méthode la plus directe pour obtenir un TLS (Transport Layer Security) fonctionnel.
sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https curl
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | sudo tee /etc/apt/sources.list.d/caddy-stable.list
sudo chmod o+r /usr/share/keyrings/caddy-stable-archive-keyring.gpg
sudo chmod o+r /etc/apt/sources.list.d/caddy-stable.list
sudo apt update
sudo apt install -y caddyRemplacez le contenu de /etc/caddy/Caddyfile par trois lignes.
ntfy.example.com {
reverse_proxy 127.0.0.1:2586
}sudo systemctl reload caddy
curl -s https://ntfy.example.com/v1/healthLe même {"healthy":true,"role":"active"} en HTTPS confirme que tout le chemin fonctionne. Un 502 de Caddy signifie généralement que ntfy n’écoute pas : vérifiez avec sudo ss -lntp | grep 2586. Si ntfy écoute et que le 502 persiste, les journaux de Caddy indiquent l’erreur rencontrée en amont, par exemple une connexion réinitialisée. Une erreur de certificat signifie généralement que l’enregistrement DNS est incorrect ou que la validation du certificat ne peut pas atteindre le serveur sur le port 80 ou 443 ; consultez sudo journalctl -u caddy -n 50 pour connaître l’erreur de validation. Pour ajouter un autre service ultérieurement, ajoutez un bloc d’hôte supplémentaire dans le même Caddyfile. C’est ainsi qu’un service comme Halcyon, une interface de vidéoclub des années 90 pour votre bibliothèque Jellyfin peut être placé sur un deuxième sous-domaine du même serveur.
Si vous utilisez déjà nginx, reprenez les paramètres de proxy documentés par ntfy : proxy_http_version 1.1, proxy_buffering off, proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for, ainsi que des délais d’attente de lecture et d’envoi d’au moins trois minutes. Un subscriber maintient une connexion HTTP ouverte aussi longtemps qu’il écoute. La valeur proxy_read_timeout par défaut de nginx, fixée à 60 secondes, ne compte que le temps entre deux lectures. ntfy envoie par défaut un message keepalive toutes les 45 secondes (keepalive-interval), précisément pour empêcher les intermédiaires de fermer la connexion pour cause d’inactivité. Un subscriber silencieux reste donc connecté même derrière la configuration nginx par défaut ; les délais plus longs fournissent une marge supplémentaire, mais ne sont pas ce qui maintient la connexion active. Si vous augmentez keepalive-interval, gardez sa valeur inférieure au délai d’attente de lecture de votre proxy.
Créer des utilisateurs et restreindre l’accès aux topics
L’authentification est activée et personne n’a encore accès à quoi que ce soit. C’est le but recherché. Créez un compte administrateur pour vous-même et un compte machine pour les scripts. Ces commandes lisent /etc/ntfy/server.yml depuis le conteneur. C’est pourquoi le fichier de configuration est monté comme volume.
sudo docker compose exec ntfy ntfy user add --role=admin admin
sudo docker compose exec ntfy ntfy user add robot
sudo docker compose exec ntfy ntfy user listChaque commande user add demande un mot de passe. Un administrateur ignore la liste de contrôle d’accès et peut lire et écrire sur tous les topics. Réservez donc ce compte à vous-même et à l’application mobile. robot est un utilisateur standard sans aucun accès tant que vous ne lui en accordez pas.
sudo docker compose exec ntfy ntfy access robot alerts write
sudo docker compose exec ntfy ntfy access robot "alerts_*" write
sudo docker compose exec ntfy ntfy accessUne entrée ACL (liste de contrôle d’accès) associe un utilisateur, un topic et une permission. Le topic est soit un nom littéral, soit un pattern dans lequel * correspond à n’importe quelle valeur. Ainsi, alerts_* couvre alerts_backup et alerts_db sans exécuter une commande pour chaque hôte. La permission write autorise uniquement la publication. Ainsi, un token volé dans un cron job ne permet pas de s’abonner au topic ni de relire ce qu’il a envoyé. Le nom d’utilisateur spécial everyone définit ce qu’un visiteur non authentifié peut faire. Avec deny-all comme valeur par défaut, vous l’utiliserez principalement pour rendre quelque chose délibérément public, comme ntfy access everyone status read. Il accepte aussi deny lorsque vous voulez une règle explicite qui interdit l’accès des visiteurs anonymes à un topic.
Les scripts doivent utiliser un token, pas votre mot de passe.
sudo docker compose exec ntfy ntfy token add robotLa commande affiche un token qui commence par tk_. Un token hérite exactement des droits de l’utilisateur auquel il appartient. Celui-ci peut donc publier sur les topics alerts et ne peut rien faire d’autre. ntfy token list affiche les éléments existants, et ntfy token remove révoque un token sans modifier le mot de passe de l’utilisateur.
Envoyez votre premier message et vérifiez que le verrou fonctionne
Commencez par vérifier que la porte est fermée.
curl -s -o /dev/null -w '%{http_code}\n' -d "hello" https://ntfy.example.com/alertsCette commande affiche 403, et 403 est la réponse attendue : auth-default-access: "deny-all" refuse une publication anonyme. Envoyez maintenant un vrai message.
curl -H "Authorization: Bearer tk_REPLACE_WITH_YOUR_TOKEN" \
-H "Title: Nightly backup finished" \
-H "Priority: default" \
-H "Tags: white_check_mark" \
-d "42 GB copied in 11 minutes" \
https://ntfy.example.com/alertsLe serveur renvoie le message enregistré au format JSON. Vous savez ainsi qu’il a été accepté et non ignoré. Title correspond à la première ligne en gras. Priority va de 1 à 5, ou de min à urgent lorsqu’il est indiqué par son nom. Il détermine si le téléphone émet un son. Tags deviennent des emoji dans la notification lorsque le nom correspond à un short code d’emoji connu, et restent du texte brut dans le cas contraire.
Pour surveiller un topic depuis un terminal, diffusez son contenu en continu :
curl -s -u admin https://ntfy.example.com/alerts/rawcurl demande le mot de passe. Chaque message arrive sur une seule ligne. Les lignes vides qui apparaissent de temps en temps sont des keepalives. Ouvrir https://ntfy.example.com dans un navigateur et vous connecter avec le même compte vous donne accès à la version web du même flux.
Définir des limites de débit pour qu’un script ne puisse pas saturer le serveur
Par défaut, chaque visiteur dispose d’un bucket de 60 requêtes, rechargé à raison d’une requête toutes les 5 secondes. C’est généreux pour un serveur privé, et un script bloqué dans une boucle de retry l’utilisera entièrement. Ajoutez des limites dans server.yml.
visitor-request-limit-burst: 30
visitor-request-limit-replenish: "10s"
visitor-message-daily-limit: 500sudo docker compose restart ntfyUn visiteur qui dépasse la limite reçoit HTTP 429 au lieu d’un message distribué. La limite est comptée par adresse du visiteur, ce qui explique l’importance de behind-proxy: true : sans lui, ntfy ne voit que l’adresse de Caddy, tous les clients sont comptés comme le même visiteur et un script bruyant épuise le bucket partagé par votre téléphone et vos autres serveurs. Depuis v2.36.0, les compteurs journaliers survivent aux redémarrages dans la base de données des utilisateurs, et le quota de chaque visiteur est réinitialisé selon son propre cycle de 24 heures plutôt qu’à minuit UTC.
Alerte en cas d’échec d’une tâche cron
Ne placez pas le token dans la ligne de commande. ps aux affiche la ligne de commande complète de chaque processus en cours à tous les utilisateurs du serveur. Un token transmis avec -H est donc lisible par n’importe quel compte local pendant toute la durée d’exécution de curl. Un fichier de configuration curl évite ce problème.
sudo install -d -m 700 /etc/ntfy-alert
printf 'header = "Authorization: Bearer tk_REPLACE_WITH_YOUR_TOKEN"\n' | sudo tee /etc/ntfy-alert/curlrc
sudo chmod 600 /etc/ntfy-alert/curlrcEncapsulez maintenant la tâche. Enregistrez ce contenu dans /usr/local/bin/backup-with-alert.sh, puis rendez-le exécutable avec chmod 750.
#!/bin/bash
out=$(/usr/local/bin/backup.sh 2>&1)
code=$?
if [ "$code" -ne 0 ]; then
printf '%s' "$out" | tail -c 1000 | curl -K /etc/ntfy-alert/curlrc \
-H "Title: backup.sh failed with exit $code" \
-H "Priority: high" \
-H "Tags: warning" \
--data-binary @- \
https://ntfy.example.com/alerts
fi
exit "$code"17 3 * * * /usr/local/bin/backup-with-alert.sh >> /var/log/backup-alert.log 2>&1$? est capturé sur la ligne qui suit immédiatement la commande, car la commande suivante l’écraserait. La sortie passe par tail -c 1000, car ntfy impose une taille maximale aux messages et une notification ne remplace pas un outil de consultation des journaux. Le exit "$code" final conserve le code de retour d’origine. Tout autre outil qui surveille cette tâche continue donc à voir un échec. Testez l’ensemble en configurant le script pour utiliser /bin/false lors d’une exécution.
Une branche d’échec qui ne s’exécute jamais est pire que l’absence d’alertes, car elle donne l’impression que le silence indique une réussite. Cron fournit à votre tâche un environnement presque vide et un PATH bien plus court que celui de votre shell de connexion. Un script qui fonctionne lorsque vous le lancez manuellement peut donc s’arrêter avant même d’atteindre la ligne curl. Le guide expliquant pourquoi une tâche cron ne s’exécute pas traite ces problèmes d’environnement. Utilisez des chemins absolus partout et consultez le fichier journal après la première exécution planifiée au lieu de partir du principe que tout fonctionne.
Alerter lorsqu’une unité systemd échoue
Cron couvre les tâches planifiées. Les services qui s’exécutent en continu ont besoin de OnFailure=, que systemd lance lorsqu’une unité passe à l’état failed. Créez une unité template et réutilisez-la pour chaque service du serveur. Enregistrez-la sous /etc/systemd/system/ntfy-unit-failed@.service.
[Unit]
Description=Send an ntfy alert because %i failed
[Service]
Type=oneshot
ExecStart=/usr/local/bin/ntfy-unit-failed %iPuis /usr/local/bin/ntfy-unit-failed, avec le mode 750 :
#!/bin/bash
unit="$1"
journalctl -u "$unit" -n 15 --no-pager -o cat | tail -c 1000 | curl -K /etc/ntfy-alert/curlrc \
-H "Title: $unit failed on $(hostname -s)" \
-H "Priority: urgent" \
-H "Tags: rotating_light" \
--data-binary @- \
https://ntfy.example.com/alertsAssociez-la à un service avec un drop-in afin qu’une mise à jour du paquet ne puisse pas écraser vos modifications.
sudo systemctl edit myapp.service[Unit]
OnFailure=ntfy-unit-failed@%n.service%n est remplacé par le nom complet de l’unité. L’unité instanciée devient donc ntfy-unit-failed@myapp.service.service. Dans le template, %i transmet myapp.service au script comme premier argument. C’est ce qui permet à un seul template de servir pour toutes les unités. Vérifiez que cela fonctionne avec une unité qui échoue volontairement, enregistrée sous /etc/systemd/system/ntfy-selftest.service.
[Unit]
Description=Deliberately failing unit
OnFailure=ntfy-unit-failed@%n.service
[Service]
Type=oneshot
ExecStart=/bin/falsesudo systemctl daemon-reload
sudo systemctl start ntfy-selftest.serviceLa commande de démarrage se termine avec un code différent de zéro et affiche Job for ntfy-selftest.service failed because the control process exited with error code. Le téléphone devrait vibrer environ une seconde plus tard. Supprimez ensuite l’unité de test.
Un piège mérite votre attention. OnFailure= s’exécute uniquement lorsqu’une unité atteint l’état failed, et RestartMode=direct ignore cet état lors des redémarrages automatiques. Il ignore donc également le gestionnaire d’échec. Avec la valeur RestartMode=normal par défaut, les redémarrages automatiques passent par l’état failed. StartLimitBurst et StartLimitIntervalSec contrôlent le moment où les démarrages répétés sont refusés. Définissez-les de sorte qu’une boucle de crash finisse par s’arrêter. Les timers sont un remplacement plus propre du modèle Cron présenté plus haut, car l’unité de service d’un timer prend en charge le même drop-in OnFailure=. le guide des services et timers systemd sur un VPS explique comment convertir l’un d’eux.
Configurer un monitor de disponibilité sur le même topic
Uptime Kuma, le monitor de disponibilité auto-hébergé, propose un type de notification ntfy. Ouvrez Settings, puis Notifications, puis Setup Notification, choisissez Ntfy, définissez l’URL du serveur sur https://ntfy.example.com et le topic sur alerts, sélectionnez une priorité, puis collez le token d’accès robot. Envoyez la notification de test avant d’enregistrer, car un nom de topic incorrect renvoie une erreur lorsqu’un grant write ne couvre pas ce topic.
La limite réelle de cette configuration est la suivante : un monitor exécuté sur le même VPS ne peut pas vous indiquer que le VPS est hors service, et ntfy ne peut pas transmettre l’information que ntfy est lui-même hors service. Exécutez le monitor sur une autre machine et donnez-lui un second canal de notification, par exemple l’e-mail, pour le monitor qui surveille ntfy lui-même. Le type de monitor Push d’Uptime Kuma couvre l’autre angle mort : votre tâche cron appelle une URL push après une exécution réussie, et Kuma vous alerte lorsque ces appels cessent d’arriver. Une branche d’échec ne se déclenche que lorsque la tâche s’exécute ; elle ne dit donc rien d’une tâche qui n’a jamais démarré.
Le ntfy auto-hébergé fonctionne-t-il sur Android et iPhone ?
Sur Android, oui, sans réserve. Installez l’application depuis Google Play ou F-Droid, ouvrez Settings, définissez le serveur par défaut sur https://ntfy.example.com, ajoutez votre compte dans l’écran de gestion des utilisateurs, puis abonnez-vous à alerts. La livraison instantanée maintient un foreground service actif afin que les messages arrivent même lorsque le téléphone est en mode doze. La notification permanente qui l’accompagne est imposée par Android pour les foreground services ; ce n’est pas un bug. La version F-Droid ne contient aucun code Firebase. Tous les abonnements utilisent donc la livraison instantanée. ntfy peut également servir de distributeur UnifiedPush, une alternative ouverte au service push de Google. Les autres applications compatibles avec UnifiedPush peuvent donc aussi transmettre leurs notifications via votre serveur.
Dans l’application iOS officielle, cela fonctionne avec une dépendance que vous ne pouvez pas supprimer. iOS suspend une application placée en arrière-plan. Les modes d’exécution en arrière-plan autorisés par Apple — lecture audio, réception des mises à jour de localisation et traitement des tâches planifiées — ne permettent pas à une application d’attendre un message de votre serveur. Un réveil rapide doit donc passer par APNs (Apple push notification service). Seul un fournisseur disposant d’identifiants autorisés pour l’application peut lui envoyer une notification. Votre serveur ne peut donc pas joindre directement l’application officielle. ntfy contourne cette contrainte avec un relais : votre serveur envoie à ntfy.sh un poll_request contenant l’identifiant du message. ntfy.sh le transmet ensuite via Firebase et APNs pour réveiller l’application. L’application récupère alors le corps du message sur votre serveur.
upstream-base-url: "https://ntfy.sh"Soyez précis sur le coût de ce fonctionnement. Le contenu du message reste sur votre serveur, mais le fait qu’un message soit arrivé et son identifiant transitent par une infrastructure que vous ne contrôlez pas. Sans ce réglage, les notifications d’un serveur auto-hébergé arrivent toujours sur iPhone, mais avec un délai imprévisible. La documentation de ntfy indique que ce délai peut atteindre plusieurs heures, car rien ne réveille rapidement l’application. Pour utiliser une application iOS native sans le relais ntfy.sh, vous devez compiler et publier vous-même l’application avec votre propre compte développeur Apple et vos propres clés APNs. Cela implique des frais annuels et une nouvelle compilation pour chaque mise à jour. Une autre solution consiste à utiliser la PWA de ntfy sur iOS 16.4 ou une version ultérieure. Ajoutez-la à l’écran d’accueil et configurez Web Push sur votre serveur. Cette solution évite le relais ntfy.sh, mais utilise toujours l’infrastructure push du navigateur. Si ce relais est inacceptable pour votre usage, conservez les alertes sur Android ou dans l’application web pour ordinateur.
Sauvegardes, mises à niveau et épinglage de l’image
Deux chemins ne peuvent pas être régénérés : /etc/ntfy/server.yml et /var/lib/ntfy/user.db. Le second contient tous les utilisateurs, les hash de mots de passe, les entrées ACL et les tokens. Traitez-le comme une clé privée.
sudo tar czf ntfy-backup.tgz -C / etc/ntfy var/lib/ntfy
sudo chmod 600 ntfy-backup.tgzCopiez ce fichier hors du serveur. cache.db contient les messages récents, pendant 12 heures avec le cache-duration ci-dessus, ainsi que les messages planifiés pour une livraison ultérieure. Ces derniers sont conservés jusqu’à 12 heures après leur livraison. Sauf si vous planifiez des messages à l’avance, sa perte ne coûte rien qu’il soit utile de protéger. Une mise à niveau consiste à modifier le tag dans le fichier Compose, à télécharger l’image, puis à recréer le conteneur.
sudo docker compose pull
sudo docker compose up -d
curl -s https://ntfy.example.com/v1/healthLisez d’abord les notes de release. Les bases SQLite sont migrées au démarrage. Revenir à un ancien tag après une modification du schéma n’est donc pas sûr. Par exemple, v2.31.1 a déplacé le cache de messages vers la version de schéma 17, et ses notes de mise à niveau indiquent qu’un downgrade vers v2.31.0 ou une version antérieure nécessite de rétablir manuellement cette version à 16. La mise à niveau vers v2.36.0 réinitialise une fois les compteurs journaliers existants de tous les utilisateurs. Conservez la sauvegarde que vous venez de créer jusqu’à ce que la nouvelle version ait fonctionné pendant une journée. Les notes signalent également des changements de comportement. Depuis v2.31.0, un client qui se reconnecte avec since=<message ID> reçoit aussi les messages publiés pendant la même seconde. Il peut donc voir un doublon. Les applications ntfy et l’application web suppriment les doublons grâce à l’identifiant du message, mais votre propre script qui rejoue un topic doit faire de même. Chaque service du serveur possède sa propre liste courte de chemins qui ne peuvent pas être régénérés, et la comparaison de PhotoPrism et Immich établit cette liste ainsi que les commandes de sauvegarde correspondantes pour une photothèque hébergée sur le même type de VPS.
Gotify et Apprise
Gotify est l’option la plus légère : un binaire avec une interface web et une application Android, avec des messages organisés par application. Il convient à un serveur privé dont Android est l’unique cible. Apprise est une bibliothèque Python et un outil en ligne de commande. Un serveur Apprise API séparé est également disponible. Il distribue un même message à plus d’une centaine de services, dont ntfy. Il convient à un script qui doit envoyer des notifications à plusieurs destinations à la fois. ntfy fournit un serveur, une API HTTP et des applications sur les deux plateformes mobiles. C’est pourquoi il constitue généralement le choix retenu pour les alertes envoyées depuis un serveur loué.
FAQ
Pourquoi la publication vers mon serveur ntfy renvoie-t-elle une erreur 403 ?
Avec auth-default-access: "deny-all" dans server.yml, la publication anonyme est refusée, ce qui est le comportement attendu. Envoyez vos identifiants avec -u user:pass ou -H "Authorization: Bearer tk_...". Si vous envoyez déjà un jeton et que vous recevez toujours 403, vérifiez si l'utilisateur associé possède une entrée ACL autorisant l'écriture sur le sujet : en l'absence d'entrée correspondante, read-only ou deny refuse la publication. Sur la version v2.34.0, des requêtes simultanées depuis la même adresse IP pouvaient entraîner le traitement de jetons valides comme anonymes ; la version v2.35.0 corrige ce bug, mettez donc à jour votre instance avant de considérer une erreur 403 intermittente comme la preuve d'un problème d'ACL. Exécutez ntfy access pour afficher la liste complète. N'oubliez pas qu'une autorisation write n'autorise pas la souscription ; un compte qui publie correctement sera donc refusé s'il tente de lire le même sujet.
Les notifications fonctionnent-elles sur iPhone avec un serveur ntfy auto-hébergé ?
Elles fonctionnent via un relais lorsque vous utilisez l'application iOS officielle. Le réveil rapide d'une application iPhone suspendue doit passer par APNs (Apple Push Notification service). L'envoi vers l'application officielle nécessite les identifiants de push de son éditeur, donc ntfy transmet un poll_request contenant l'ID du message à ntfy.sh, qui le relaie vers l'appareil. Configurez upstream-base-url: "https://ntfy.sh" dans server.yml et redémarrez le conteneur. Le corps du message est toujours récupéré depuis votre serveur. Sans ce paramètre, les notifications iOS finissent par arriver, mais la documentation de ntfy prévient que le délai peut atteindre plusieurs heures. La PWA offre une autre voie sur iOS 16.4 ou version ultérieure lorsque le Web Push est configuré sur votre serveur.
Pourquoi mon alerte ntfy via une tâche cron n'est-elle jamais arrivée ?
Exécutez d'abord la ligne curl seule pour confirmer que le jeton et le sujet sont corrects. Si cela fonctionne manuellement mais pas via cron, l'échec se situe en amont de l'alerte : cron exécute les tâches avec un environnement minimal et un PATH court. Un script qui appelle une commande par son nom simple peut échouer avant d'atteindre la ligne curl. Utilisez des chemins absolus, redirigez la sortie de la tâche vers un fichier de journalisation et consultez ce fichier après la prochaine exécution. Une réponse 429 au lieu d'une livraison signifie qu'une limite a refusé la requête. Habituellement, le script réessaie trop rapidement, mais un visiteur ayant épuisé un quota journalier, comme la limite de messages définie plus haut, est refusé de la même manière, même pour une requête unique.
Dois-je exposer ntfy sur l'internet public ?
Les applications mobiles doivent pouvoir l'atteindre depuis les réseaux cellulaires. Un point de terminaison HTTPS public avec auth-default-access: "deny-all" et des ACL par sujet est la configuration standard. Cela est sécurisé tant qu'aucun sujet n'est lisible par everyone. Une instance accessible uniquement via VPN est pertinente si chaque abonné est une machine que vous contrôlez. C'est une solution inadaptée aux téléphones, car l'application ne reçoit les alertes que lorsque le tunnel est actif ; les alertes sont donc mises en file d'attente jusqu'à ce que le téléphone se reconnecte.