Héberger ntfy sur un VPS infogéré, c'est envoyer vos notifications push par une simple requête HTTP, PUT ou POST, depuis une machine à vous, que nos équipes tiennent à jour et supervisent jour et nuit. Logiciel libre, ntfy est publié sous double licence, Apache 2.0 et GPLv2. Ce guide suit sa documentation officielle, à la version 2.38.1 : l'installation avec Docker Compose, le fichier server.yml, les utilisateurs et les droits d'accès, les jetons, HTTPS, les applications mobiles, l'e-mail, les sauvegardes et les mises à jour.
Par Simon Vasconcelos Lee
Publié le 21 novembre 2026Lecture : 15 minutes
binwiederhier/ntfy, un server.yml avec base-url, cache-file et auth-file, et le port publié sur 127.0.0.1 derrière un proxy inverse en HTTPS.auth-default-access: deny-all, créez un administrateur avec ntfy user add, puis donnez à chaque script un jeton et des droits limités.server.yml et user.db, qui gardent la configuration, les utilisateurs, les droits et les jetons ; mettez à jour en changeant l'étiquette de l'image, notes de version lues.ntfy, qui se prononce « notify », est un service de notification par HTTP, sur le modèle publication et abonnement. Son README le présente comme une façon d'envoyer des notifications à son téléphone ou à son ordinateur depuis des scripts, depuis n'importe quelle machine. Le projet en fait tourner une instance publique, ntfy.sh, et le serveur s'auto-héberge : c'est l'objet de ce guide.
curl, un script, une tâche planifiée ou une autre application. Le message peut porter un titre, une priorité de 1 à 5, des étiquettes et des émojis, une pièce jointe, des boutons d'action ou une heure d'envoi différée.ntfy, ou l'API, par WebSocket ou par un flux HTTP qui reste ouvert.curl -d "Sauvegarde terminée" https://ntfy.example.com/sauvegardes
Le README de ntfy le dit publié sous double licence : la licence Apache 2.0, dans le fichier LICENSE, et la GNU GPL version 2, dans LICENSE.GPLv2. L'image Docker déclare les deux, Apache-2.0, GPL-2.0.
Faire tourner ntfy sur votre serveur, pour votre entreprise, votre équipe ou vos clients, se fait donc sans licence à acheter. Les deux textes fournissent le logiciel sans garantie.
La licence couvre le code. Le nom relève à part : la licence Apache 2.0 n'accorde aucun droit sur les marques du concédant, et les conditions d'utilisation de ntfy.sh indiquent que le nom, le logo et l'identité visuelle de ntfy sont des marques de ntfy LLC, dont l'usage pour un produit ou un service demande son accord écrit préalable. Ce guide cite le nom pour décrire le logiciel.
Cette publication est indépendante du projet ntfy et de ntfy LLC : elle n'est ni affiliée à eux, ni parrainée, ni approuvée par eux.
Le serveur est un binaire unique, compilé statiquement, pour amd64, armv7 et arm64 ; l'image Docker existe aussi pour armv6. La documentation ne chiffre ni la mémoire ni le processeur : pour un serveur personnel, écrit-elle, la montée en charge n'est pas un sujet. Elle désigne plutôt ce qui borne une instance :
nofile, le permet. Le service systemd du paquet la fixe à 10 000.Sur un VPS infogéré, décrivez-nous vos usages, le nombre d'appareils abonnés, le volume de messages et les pièces jointes, et nous vous recommandons la taille qui convient.
La documentation propose l'image binwiederhier/ntfy de Docker Hub. Elle sert l'application web et l'API sur le port 80 du conteneur, et ne contient pas de fichier server.yml : la configuration se place dans un dossier monté sur /etc/ntfy. Sur un serveur où Docker est installé, créez un dossier et placez-y ce compose.yaml, tiré de l'exemple de la documentation :
services:
ntfy:
image: binwiederhier/ntfy:v2.38.1
container_name: ntfy
command:
- serve
environment:
- TZ=UTC
volumes:
- ./etc:/etc/ntfy
- ./lib:/var/lib/ntfy
ports:
- "127.0.0.1:2586:80"
healthcheck:
test: ["CMD-SHELL", "wget -q --tries=1 http://localhost:80/v1/health -O - | grep -Eo '\"healthy\"\\s*:\\s*true' || exit 1"]
interval: 60s
timeout: 10s
retries: 3
start_period: 40s
restart: unless-stopped
init: true
Puis le fichier de configuration, dans etc/server.yml, avec l'adresse publique de votre serveur :
base-url: "https://ntfy.example.com"
cache-file: "/var/lib/ntfy/cache.db"
attachment-cache-dir: "/var/lib/ntfy/attachments"
auth-file: "/var/lib/ntfy/user.db"
auth-default-access: "deny-all"
behind-proxy: true
enable-login: true
docker compose up -d
curl http://127.0.0.1:2586/v1/health
Le serveur répond {"healthy":true,"role":"active"}. Ce que fait chaque réglage :
127.0.0.1:2586 : les exemples Docker de la documentation publient le port 80 sur toutes les adresses, et ses exemples de proxy inverse transmettent à 127.0.0.1:2586. Publié ainsi, le port n'est joignable que depuis le serveur lui-même, et l'API s'atteint par le seul proxy inverse, en HTTPS.base-url : l'adresse publique du service. Le fichier d'exemple server.yml la demande pour les pièces jointes, l'envoi d'e-mails et les notifications iOS d'un serveur auto-hébergé.cache-file : sans lui, les messages restent en mémoire 12 heures et se perdent au redémarrage. Ce cache permet aux téléphones mal connectés de récupérer les messages manqués.attachment-cache-dir : active les pièces jointes. ntfy prend le contrôle complet de ce dossier, à réserver à cet usage.auth-file et auth-default-access: deny-all : la base des utilisateurs et des droits, créée au premier démarrage, et le refus par défaut de tout accès anonyme. C'est le réglage que la documentation recommande pour une instance privée.behind-proxy : sans lui, derrière un proxy, tous les visiteurs partagent l'adresse IP du proxy et les mêmes limites de débit.enable-login : permet de se connecter à l'application web. Les inscriptions libres restent fermées, enable-signup valant false par défaut.v2.38.1 fixe la version ; latest suit la dernière publiée. La documentation propose aussi user: UID:GID pour un compte non root : les fichiers de etc et lib lui appartiennent alors.Le projet publie aussi un dépôt de paquets, signé par la clé d'empreinte 55BA 774A 6F5E E674 31E4 B6B7 CFDB 962D 4F1E C4AF. Sur un serveur amd64 :
sudo mkdir -p /etc/apt/keyrings
sudo curl -L -o /etc/apt/keyrings/ntfy.gpg https://archive.ntfy.sh/apt/keyring.gpg
sudo apt install apt-transport-https
echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/ntfy.gpg] https://archive.ntfy.sh/apt stable main" \
| sudo tee /etc/apt/sources.list.d/ntfy.list
sudo apt update
sudo apt install ntfy
sudo systemctl enable ntfy
sudo systemctl start ntfy
Le paquet lit /etc/ntfy/server.yml. Le fichier d'exemple y conseille /var/cache/ntfy/cache.db pour le cache et /var/lib/ntfy/user.db pour les utilisateurs, deux dossiers que le paquet crée. Derrière un proxy, ajoutez listen-http: "127.0.0.1:2586".
Sans configuration, un serveur ntfy est ouvert : tout le monde lit et écrit sur tous les sujets, et le nom du sujet tient lieu de mot de passe. Avec auth-file et deny-all, plus rien ne passe sans identifiants. ntfy connaît deux rôles : admin, qui lit et écrit sur tous les sujets, et user, qui n'a que les droits que vous lui donnez.
docker compose exec ntfy ntfy user add --role=admin alice
La commande demande le mot de passe, puis sa confirmation. Les commandes ntfy user, ntfy access et ntfy token écrivent directement dans la base des utilisateurs : elles se lancent sur le serveur, ici dans le conteneur, qui lit le chemin de cette base dans server.yml.
Un jeton d'accès donne aujourd'hui un accès complet au compte de son utilisateur, sauf le changement de mot de passe et la suppression du compte. Pour un script, créez donc un utilisateur dédié, limité à ses sujets, puis un jeton pour lui :
docker compose exec ntfy ntfy user add serveur-sauvegarde
docker compose exec ntfy ntfy access serveur-sauvegarde sauvegardes write-only
docker compose exec ntfy ntfy token add --label="sauvegardes" serveur-sauvegarde
read-write, read-only, write-only ou deny, sur un sujet précis ou sur un motif comme alertes-*, seul caractère générique accepté.everyone, ou *. Pour UnifiedPush sur une instance privée, la documentation ouvre en écriture seule les sujets qui commencent par up : ntfy access '*' 'up*' write-only.tk_, peuvent expirer avec --expires=30d, et chaque utilisateur en garde jusqu'à 60. ntfy token list les affiche, ntfy token remove en retire un.auth-users, auth-access et auth-tokens créent les mêmes objets depuis server.yml, à chaque démarrage. Un utilisateur retiré de cette liste est supprimé de la base au redémarrage suivant.Le script publie ensuite avec son jeton, en HTTPS :
curl \
-H "Authorization: Bearer tk_AgQdq7mVBoFD37zQVN29RhuMzNIz2" \
-H "Title: Sauvegarde terminée" \
-H "Priority: high" \
-d "La sauvegarde de nuit s'est bien passée." \
https://ntfy.example.com/sauvegardes
Un mot de passe en Basic auth n'est qu'encodé en base64, pas chiffré : la documentation demande HTTPS pour tout serveur auto-hébergé. C'est l'objet de la section suivante.
ntfy sait servir HTTPS lui-même, mais derrière un proxy la documentation recommande de confier le chiffrement au proxy. Deux points comptent plus que tout le reste :
Upgrade et Connection, et laisse vivre ces connexions longues. ntfy envoie un message de maintien toutes les 45 secondes par défaut, keepalive-interval, pour qu'aucun intermédiaire ne les coupe.behind-proxy: true, ntfy lit l'en-tête X-Forwarded-For et retient l'adresse la plus à droite, celle qu'ajoute votre proxy. C'est sur elle que portent les limites de débit.La documentation note que Caddy gère HTTP et WebSocket sans réglage avec reverse_proxy. Il obtient seul le certificat Let's Encrypt :
ntfy.example.com {
reverse_proxy 127.0.0.1:2586
}
Ce bloc reprend la configuration de la documentation, proche de celle de ntfy.sh : la mise en tampon désactivée pour les flux, des délais de 3 minutes, et aucune limite de taille sur le corps des requêtes, que ntfy plafonne lui-même. Il écoute sur le port 80 pour laisser Certbot poser HTTPS :
server {
listen 80;
listen [::]:80;
server_name ntfy.example.com;
location / {
proxy_pass http://127.0.0.1:2586;
proxy_http_version 1.1;
proxy_buffering off;
proxy_request_buffering off;
proxy_redirect off;
proxy_set_header Host $http_host;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_connect_timeout 3m;
proxy_send_timeout 3m;
proxy_read_timeout 3m;
client_max_body_size 0;
}
}
sudo ln -s /etc/nginx/sites-available/ntfy /etc/nginx/sites-enabled/
sudo nginx -t
sudo certbot --nginx -d ntfy.example.com
Une fois HTTP redirigé vers HTTPS, publiez en https:// dans vos scripts. Pour des milliers d'abonnés, la documentation relève worker_connections dans nginx.conf et la limite LimitNOFILE du service Nginx, au double des connexions visées.
Les applications de ntfy ajoutent des sujets de votre serveur aussi bien que de ntfy.sh : indiquez son adresse à l'ajout du sujet, et pour un sujet protégé, l'identifiant et le mot de passe d'un utilisateur qui y a accès. L'application web, elle, est servie à l'adresse même du serveur.
ntfy webpush keys et un certificat HTTPS valide.Ajoutez une ligne à server.yml, puis redémarrez le conteneur :
upstream-base-url: "https://ntfy.sh"
À chaque message, votre serveur publie alors sur ntfy.sh une demande de relève, qui ne contient que l'identifiant du message et l'empreinte SHA-256 de l'adresse du sujet. ntfy.sh la transmet à l'appareil par les services de notification d'Apple, puis l'application vient chercher le message sur votre serveur. Le texte qui transite par ntfy.sh est toujours le même, « New message », quel que soit le vôtre. Sans ce réglage, les notifications arrivent quand même, avec un délai qui peut aller jusqu'à plusieurs heures selon l'état du téléphone. upstream-access-token ajoute un jeton si vous dépassez les limites de ntfy.sh.
ntfy limite chaque visiteur, identifié par son adresse IP, et pour IPv6 par son sous-réseau /64. Ces limites protègent le serveur des abus ; en usage normal, la documentation précise qu'on ne les atteint pas. Au-delà, le serveur répond 429 Too Many Requests. Les valeurs par défaut :
| Réglage | Par défaut | Ce qu’il limite |
|---|---|---|
visitor-request-limit-burst | 60 | Les requêtes d’un visiteur d’un seul coup |
visitor-request-limit-replenish | 5s | Le rythme de recharge : une requête toutes les 5 secondes |
visitor-subscription-limit | 30 | Les connexions ouvertes par visiteur |
visitor-message-daily-limit | Aucune | Les messages par jour, sinon régis par la limite de requêtes |
visitor-email-limit-burst | 16 | Les e-mails d’un seul coup, puis un par heure |
visitor-attachment-total-size-limit | 100M | Le stockage de pièces jointes par visiteur |
visitor-attachment-daily-bandwidth-limit | 500M | Le trafic de pièces jointes par visiteur et par jour |
global-topic-limit | 15 000 | Le nombre total de sujets du serveur |
message-size-limit | 4K | La taille d’un message ; au-delà, il devient une pièce jointe |
visitor-request-limit-exempt-hosts, une liste d'adresses IP ou de noms d'hôte.ntfy tier, donnent à certains comptes des limites plus hautes.attachment-file-size-limit, 15M par défaut, plafonne chaque fichier, attachment-total-size-limit, 5G, l'ensemble, et attachment-expiry-duration, 3h, leur durée de vie. Une pièce jointe ne survit jamais à son message : pour la garder plus longtemps, relevez aussi cache-duration.ntfy peut transférer un message par e-mail quand la publication porte l'en-tête Email, ou X-Email, avec une adresse. Il passe pour cela par un serveur SMTP d'envoi, en STARTTLS, avec une authentification PLAIN ou LOGIN : c'est le port 587. Sur un VPS Simafri, l'envoi passe par un relais SMTP authentifié, sur ce même port 587 : configurez ici l'adresse d'un compte de messagerie que vous avez déjà, ou celle de votre service d'envoi.
smtp-sender-addr: "smtp.example.com:587"
smtp-sender-user: "ntfy@example.com"
smtp-sender-pass: "mot-de-passe-smtp"
smtp-sender-from: "ntfy@example.com"
curl \
-H "Authorization: Bearer tk_AgQdq7mVBoFD37zQVN29RhuMzNIz2" \
-H "Email: alice@example.com" \
-d "Le disque du serveur de fichiers dépasse 90 %." \
https://ntfy.example.com/alertes
base-url et smtp-sender-from sont exigés dès que smtp-sender-addr est posé : le serveur refuse de démarrer sans eux.smtp-sender-verify: true réserve l'envoi aux adresses que chaque utilisateur a vérifiées dans son compte, et le ferme aux anonymes.server.yml : réservez la lecture de ce fichier à son propriétaire, avec chmod 600.Avec SQLite, ntfy garde chaque type de données dans son propre fichier. Dans l'installation de ce guide, tout se trouve dans les dossiers etc et lib, à côté du compose.yaml :
| Élément | Ce qu’il garde | À sauvegarder |
|---|---|---|
etc/server.yml | La configuration, dont les secrets SMTP et les clés Web Push | Oui |
lib/user.db | Les utilisateurs, les droits d’accès, les jetons et les compteurs quotidiens | Oui |
lib/cache.db | Les messages des 12 dernières heures, par défaut | Utile, sa durée de vie est courte |
lib/attachments/ | Les pièces jointes des 3 dernières heures, par défaut | Utile, sa durée de vie est courte |
Fichier web-push-file | Les abonnements Web Push des navigateurs, si vous l’avez activé | Oui |
Pour une copie cohérente des fichiers SQLite, arrêtez le service le temps de l'archive :
docker compose stop
tar -czf ntfy-$(date +%F).tar.gz compose.yaml etc lib
docker compose start
Planifiez cette copie à une heure creuse, et envoyez-la hors du serveur. Posées sur son disque, ces archives entrent aussi dans ses sauvegardes de nuit. Pour restaurer, remettez les dossiers en place, puis relancez docker compose up -d.
Si vous perdez user.db sans copie, les utilisateurs et les jetons déclarés dans server.yml par auth-users et auth-tokens sont recréés au démarrage ; ceux créés en ligne de commande sont à refaire.
Avec Docker, changez l'étiquette de l'image dans compose.yaml, par exemple de v2.38.1 à la version suivante, puis :
docker compose pull
docker compose up -d
Les dossiers etc et lib restent en place, et ntfy migre lui-même ses bases au démarrage. Avec le paquet Debian, sudo apt update puis sudo apt upgrade font la même chose.
Les notes de chaque version, dans la page « Releases » de la documentation, regroupent sous « Upgrade notes » ce qui change pour une instance existante, comme en 2.36.0 une configuration désormais vérifiée en entier au démarrage, ou des compteurs quotidiens remis à zéro. Lisez-les avant de mettre à jour, et faites une copie des deux dossiers juste avant. La version 2.38.1 est une version de sécurité, que le projet recommande vivement : elle renforce les modèles de messages contre les dénis de service, et empêche les envois lents de pièces jointes vers S3 et les points de terminaison web push qui ne répondent plus d'immobiliser la mémoire et les connexions. Elle suit la 2.38.0, qui apporte le partage des limites de débit entre les nœuds d'un cluster et se construit avec Go 1.27.4.
L'auto-hébergement demande de tenir le serveur en plus de l'application. Sur un VPS infogéré, nos équipes prennent le serveur en main et suivent votre instance de manière proactive ; ntfy reste votre logiciel, avec ses réglages et ses données.
| Sujet | Nos équipes | Vous |
|---|---|---|
| Le serveur | Mises à jour du système et de la sécurité, interventions sur le serveur comprises | Le moment qui convient à votre activité |
| La supervision | Serveur suivi 24 h/24 et 7 j/7, avec intervention sans attendre votre appel | La lecture des journaux de votre instance |
| ntfy | Suivi proactif : erreurs, lenteurs, connexions ouvertes et espace disque repérés, correction recommandée | Son installation, ses mises à jour et ses réglages, que vous appliquez, vous ou votre assistant IA |
| Les accès | Le serveur qui les porte, surveillé et sauvegardé | Les utilisateurs, les droits sur les sujets et les jetons de vos scripts |
| Les sauvegardes | Chaque nuit, chiffrées et gardées hors de la machine ; restauration comprise | Les copies propres à ntfy, et la demande de restauration, quand vous en avez besoin |
| La migration | Votre serveur actuel migré, offert | Le moment de la bascule |
Si vous préférez que nos équipes interviennent dans l'application elle-même, cette prestation se facture à l'heure ou au forfait, avec un chiffrage communiqué avant l'intervention.
Avec un VPS infogéré Simafri, nos équipes tiennent à jour le serveur de votre instance ntfy, le surveillent jour et nuit et interviennent sans attendre votre appel ; elles suivent aussi votre instance de manière proactive et vous recommandent les corrections utiles, que vous appliquez, vous ou votre assistant IA. Les sauvegardes sont chiffrées chaque nuit et gardées hors de la machine, leur restauration est comprise, et la migration de votre serveur actuel est offerte.
Oui. ntfy est publié sous double licence, Apache 2.0 et GPLv2 : vous pouvez le faire tourner en entreprise sans licence à acheter. Leurs conditions portent sur la redistribution du logiciel. Reste le coût du serveur qui le fait tourner.
Créez un compose.yaml avec l'image binwiederhier/ntfy, la commande serve, un dossier monté sur /etc/ntfy pour server.yml, un autre sur /var/lib/ntfy pour les bases, et le port 80 du conteneur publié sur 127.0.0.1:2586. Lancez docker compose up -d, puis placez un proxy inverse en HTTPS devant ce port.
Dans server.yml, posez auth-file et auth-default-access: deny-all. Créez ensuite un administrateur avec ntfy user add --role=admin, des utilisateurs limités avec ntfy user add, et leurs droits sur les sujets avec ntfy access.
Créez un jeton avec ntfy token add pour un utilisateur dédié au script, limité à ses sujets, puis publiez avec curl et l'en-tête Authorization: Bearer suivi du jeton, en HTTPS. Un jeton donne accès à tout le compte de son utilisateur.
Derrière un proxy inverse, toutes les requêtes arrivent de l'adresse du proxy. Avec behind-proxy: true, ntfy lit l'en-tête X-Forwarded-For pour identifier chaque visiteur ; sans lui, tous partagent les mêmes limites de débit.
Oui, avec upstream-base-url: "https://ntfy.sh" dans server.yml. Votre serveur fait alors relayer par ntfy.sh un signal qui ne contient que l'identifiant du message, et l'application vient chercher le message sur votre serveur. Sans ce réglage, la livraison peut prendre plusieurs heures.
Sauvegardez server.yml et user.db, qui gardent la configuration, les utilisateurs, les droits et les jetons, et le fichier Web Push s'il est activé. Le cache des messages et les pièces jointes ont une durée de vie courte. Arrêtez le service le temps de la copie, pour des fichiers SQLite cohérents.
Un VPS infogéré couvre le serveur : système, sécurité, supervision et sauvegardes. Nos équipes suivent aussi votre instance de manière proactive et vous recommandent les corrections utiles, que vous appliquez. Une intervention dans l'application se facture à l'heure ou au forfait.
Simafri
Parlons de votre projet
Dites-nous en deux mots ce qu'il vous faut : on revient vers vous rapidement.
Merci ! Votre demande a bien été envoyée. Nous vous répondrons rapidement.
Vous préférez l'email ? Écrivez-nous à support@simafri.com.