Héberger ntfy sur un VPS infogéré : vos notifications push sur votre serveur

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.

Simon Vasconcelos Lee Par Publié le 21 novembre 2026Lecture : 15 minutes

Tous les guides

L'essentiel

  1. ntfy reçoit un message par une requête HTTP PUT ou POST sur un sujet, et le pousse aussitôt aux téléphones, navigateurs et scripts abonnés à ce sujet.
  2. Sa double licence, Apache 2.0 et GPLv2, permet de le faire tourner librement en entreprise ; ses conditions portent sur la redistribution du logiciel.
  3. Installez-le avec Docker Compose : l'image 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.
  4. Par défaut, tout le monde lit et écrit sur tous les sujets : posez auth-default-access: deny-all, créez un administrateur avec ntfy user add, puis donnez à chaque script un jeton et des droits limités.
  5. Sauvegardez 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.

Ce que fait ntfy

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.

Terminal, une première publication
curl -d "Sauvegarde terminée" https://ntfy.example.com/sauvegardes

Les licences Apache 2.0 et GPLv2, et la marque

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.

Les ressources à prévoir

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 :

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.

L'installation avec Docker Compose

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 :

compose.yaml
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 :

etc/server.yml
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
Terminal, dans le dossier du compose.yaml
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 :

Sans Docker : le dépôt Debian et Ubuntu

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 :

Terminal
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".

Utilisateurs, droits d'accès et jetons

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.

Terminal, le premier administrateur
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 utilisateur et un jeton par script

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 :

Terminal
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

Le script publie ensuite avec son jeton, en HTTPS :

Terminal, sur la machine qui publie
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.

HTTPS : le proxy inverse

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 :

Avec Caddy

La documentation note que Caddy gère HTTP et WebSocket sans réglage avec reverse_proxy. Il obtient seul le certificat Let's Encrypt :

Caddyfile
ntfy.example.com {
    reverse_proxy 127.0.0.1:2586
}

Avec Nginx

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 :

/etc/nginx/sites-available/ntfy
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;
    }
}
Terminal
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 Android, iOS et web

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.

Les notifications instantanées sur iOS

Ajoutez une ligne à server.yml, puis redémarrez le conteneur :

etc/server.yml
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.

Les limites de débit et les pièces jointes

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églagePar défautCe qu’il limite
visitor-request-limit-burst60Les requêtes d’un visiteur d’un seul coup
visitor-request-limit-replenish5sLe rythme de recharge : une requête toutes les 5 secondes
visitor-subscription-limit30Les connexions ouvertes par visiteur
visitor-message-daily-limitAucuneLes messages par jour, sinon régis par la limite de requêtes
visitor-email-limit-burst16Les e-mails d’un seul coup, puis un par heure
visitor-attachment-total-size-limit100MLe stockage de pièces jointes par visiteur
visitor-attachment-daily-bandwidth-limit500MLe trafic de pièces jointes par visiteur et par jour
global-topic-limit15 000Le nombre total de sujets du serveur
message-size-limit4KLa taille d’un message ; au-delà, il devient une pièce jointe

Les notifications par e-mail

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.

etc/server.yml
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"
Terminal
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

Les sauvegardes

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émentCe qu’il gardeÀ sauvegarder
etc/server.ymlLa configuration, dont les secrets SMTP et les clés Web PushOui
lib/user.dbLes utilisateurs, les droits d’accès, les jetons et les compteurs quotidiensOui
lib/cache.dbLes messages des 12 dernières heures, par défautUtile, sa durée de vie est courte
lib/attachments/Les pièces jointes des 3 dernières heures, par défautUtile, sa durée de vie est courte
Fichier web-push-fileLes 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 :

Terminal, dans le dossier du compose.yaml
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.

Les mises à jour

Avec Docker, changez l'étiquette de l'image dans compose.yaml, par exemple de v2.38.1 à la version suivante, puis :

Terminal, dans le dossier du compose.yaml
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.

Qui fait quoi sur un VPS infogéré

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.

SujetNos équipesVous
Le serveurMises à jour du système et de la sécurité, interventions sur le serveur comprisesLe moment qui convient à votre activité
La supervisionServeur suivi 24 h/24 et 7 j/7, avec intervention sans attendre votre appelLa lecture des journaux de votre instance
ntfySuivi proactif : erreurs, lenteurs, connexions ouvertes et espace disque repérés, correction recommandéeSon installation, ses mises à jour et ses réglages, que vous appliquez, vous ou votre assistant IA
Les accèsLe serveur qui les porte, surveillé et sauvegardéLes utilisateurs, les droits sur les sujets et les jetons de vos scripts
Les sauvegardesChaque nuit, chiffrées et gardées hors de la machine ; restauration compriseLes copies propres à ntfy, et la demande de restauration, quand vous en avez besoin
La migrationVotre serveur actuel migré, offertLe 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.

ntfy, sur un serveur tenu pour vous

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.

Découvrir les VPS infogérés

Questions fréquentes

ntfy est-il gratuit pour une entreprise ?

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.

Comment installer ntfy avec Docker Compose ?

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.

Comment rendre un serveur ntfy privé ?

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.

Comment publier vers ntfy depuis un script avec un jeton ?

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.

Pourquoi régler behind-proxy dans ntfy ?

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.

Les notifications ntfy arrivent-elles tout de suite sur iPhone ?

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.

Comment sauvegarder ntfy ?

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-t-il ntfy ?

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.

Guides liés

Héberger Uptime Kuma sur un VPS infogéré : surveillez vos services en continuHéberger Uptime Kuma sur un VPS infogéré, c'est surveiller vos sites, vos API et vos serveurs depuis une machine à vous, que nos équipes tiennent à jour et supervisent jour et nuit. Uptime Kuma est un logiciel libre sous licence MIT. Ce guide suit sa documentation officielle : l'installation avec Docker Compose, HTTPS, la base de données, les notifications, les sauvegardes et les mises à jour.Différence entre VPS infogéré et non infogéré : qui fait quoiLa différence entre un VPS infogéré et un VPS non infogéré tient à une question : qui s'occupe du serveur une fois qu'il tourne. Le mot « infogéré » n'a pourtant pas de définition officielle, et va d'un hébergeur à l'autre d'une simple installation du système à l'exploitation complète du serveur. Ce guide montre qui fait quoi, ligne par ligne, avec le niveau intermédiaire de l'assistance, et donne les questions qui lèvent l'ambiguïté avant de signer.Sauvegardes d'un VPS : ce qu'il faut vérifier avant de signerUne offre de VPS annonce presque toujours « sauvegardes comprises ». Derrière ces deux mots, il peut y avoir une copie chaque nuit, gardée hors de la machine et restaurée par des experts, ou un instantané posé sur le même disque que le serveur. Ce guide donne les questions qui font la différence, ce que chaque réponse veut dire, et la façon de vérifier qu'une sauvegarde se restaure.
Contactez-nous