ntfy

À propos de ntfy

Ce qui est installé

Prêt au démarrage du VPS

OS compatibles

Ubuntu 24.04

Application

ntfy

Stack technique

DockerGo

RAM minimum

512 Mo

CPU minimum

1 vCPU

Port par défaut

8080

Accès

root par SSH

Fonctionnalités clés

• Publication en une ligne : curl -d "Sauvegarde OK" https://votre-domaine.com/mon-sujet depuis n'importe quelle machine, ou curl -d "Sauvegarde OK" http://127.0.0.1:8080/mon-sujet depuis le VPS lui-même — sans bibliothèque cliente ni clé d'API
• Réception sur Android, iOS, navigateur et interface web ; les abonnés reçoivent le même sujet en WebSocket ou SSE
• Niveaux de priorité, de minimale à urgente, avec contournement du mode Ne pas déranger sur mobile pour les alertes critiques
• Actions dans la notification : des boutons qui déclenchent un appel HTTP, ouvrent une URL ou lancent une commande sur l'appareil abonné
• Envoi différé via l'en-tête X-Delay et pièces jointes jusqu'à 15 Mo via X-Attach
• Contrôle d'accès optionnel : comptes, listes d'autorisations par sujet et jetons en publication seule ou abonnement seul, gérés par ntfy user, ntfy access et ntfy token

Quand utiliser cette solution ?

Guide

Déployer ntfy sur votre VPS

1. 1

   Commander un VPS ServOrbit

   Une offre de 512 Mo de RAM est largement suffisante : ntfy consomme moins de 30 Mo au repos et n'a aucune dépendance lourde. Vous pouvez l'héberger sur un VPS qui fait déjà tourner Uptime Kuma ou vos applications, pour constituer une chaîne d'alerte entièrement auto-hébergée.

2. 2

   Déployer ntfy depuis le Marketplace

   Dans votre espace client ServOrbit, ouvrez le Marketplace, catégorie Monitoring, sélectionnez ntfy et lancez le déploiement. Docker récupère l'image binwiederhier/ntfy:latest et démarre le serveur sur le port 8080. Aucun fichier de configuration ni compte n'est requis pour commencer.

3. 3

   Se connecter la première fois

   ntfy démarre SANS aucun compte ni mot de passe : l'URL s'ouvre directement sur l'interface, et quiconque connaît l'adresse peut lire ET publier sur n'importe quel sujet. Si votre serveur est joignable depuis Internet, activez l'authentification avant de vous en servir sérieusement.

4. 4

   Publier votre premier message

   Le conteneur écoute sur 127.0.0.1:8080, en local sur le VPS. Connectez-vous en SSH et testez avec curl -d "Bonjour depuis mon VPS" http://127.0.0.1:8080/mon-sujet. Ouvrez ensuite l'interface web par un tunnel — ssh -L 8080:127.0.0.1:8080 root@<ip> puis http://127.0.0.1:8080 — et sélectionnez le sujet mon-sujet pour voir le message arriver. Les sujets se créent à la première publication.

5. 5

   Publier un sous-domaine pour l'accès externe

   Pour recevoir les notifications sur mobile ou les émettre depuis d'autres machines, le serveur doit être joignable depuis l'extérieur : c'est exactement le rôle du domaine. Attachez-en un à l'application depuis votre espace client ServOrbit, par exemple ntfy.votre-domaine.fr : ServOrbit pose lui-même le vhost, le certificat TLS et le renvoi vers le port 8080 local, et le conteneur est déjà configuré pour fonctionner derrière un proxy. Vos appareils publient et s'abonnent alors sur https://ntfy.votre-domaine.fr, sans numéro de port. HTTPS est également ce qui permet aux navigateurs de recevoir les notifications en arrière-plan.

6. 6

   Abonner votre téléphone et brancher vos outils

   Installez l'application ntfy (Android via F-Droid ou Google Play, iOS via l'App Store), ajoutez l'URL de votre serveur et le nom du sujet. Configurez ensuite vos outils : dans Uptime Kuma, section Notifications, choisissez ntfy et renseignez l'URL du serveur et le sujet ; répétez pour Changedetection.io, Gatus ou Grafana avec un sujet différent par source.