Installer ntfy sur un Raspberry Pi avec Docker offre une solution simple, efficace et entièrement personnalisable pour gérer vos notifications locales. Ce guide complet vous accompagne pas à pas dans :
- la mise en place d’un serveur de notifications léger et fiable via Docker,
- la configuration adaptée à un Raspberry Pi 4 ou 5 avec Raspberry Pi OS 64 bits,
- l’intégration d’alertes pratiques pour vos projets domotiques ou scripts personnels,
- les bonnes pratiques de sécurité pour un usage en réseau local,
- et la gestion des messages de test et automatisations ultérieures.
Grâce à cette méthode, vous pourrez centraliser vos alertes, qu’elles concernent une sauvegarde terminée, une anomalie détectée, ou la présence d’un appareil sur votre réseau, sans dépendre d’un service tiers. Suivez ces conseils pour bâtir un système de notifications sur mesure, accessible depuis un téléphone, un PC ou un navigateur.
A lire aussi : Windows 10 arrive en fin de support en 2026 : découvrez les véritables dangers pour votre PC
Pourquoi installer ntfy sur Raspberry Pi avec Docker pour un système de notifications personnalisé
ntfy est une solution légère conçue pour recevoir des messages HTTP et les redistribuer en temps réel aux clients abonnés sur des sujets spécifiques. Avec un Raspberry Pi 4 ou 5 tournant sur une version 64 bits de Raspberry Pi OS, vous disposez d’une plate-forme parfaite pour héberger ce serveur de notifications grâce à la containerisation offerte par Docker. Cette association garantit :
- une installation simplifiée et reproductible, grâce aux conteneurs isolés,
- une gestion centralisée des notifications locales, évitant les dépendances externes,
- une consommation maîtrisée des ressources, parfaitement adaptée aux performances du Raspberry Pi,
- et une flexibilité totale pour connecter ntfy à d’autres systèmes comme Home Assistant ou des scripts personnalisés.
En pratique, un conteneur ntfy sur votre Pi peut gérer aisément plusieurs sujets de notifications, envoyant des alertes importantes sans retards ni surcharges. Cette méthode sécurise aussi votre réseau, puisque le service reste sur la couche locale, évitant toute exposition superflue vers Internet sans protection.
Lire également : Watchtower sur Raspberry Pi : comment mettre à jour vos conteneurs Docker en toute sécurité
Matériel et prérequis pour une installation réussie de ntfy sur Raspberry Pi
Pour garantir une expérience fluide, voici la configuration recommandée :
| Élément | Détail & Conseil |
|---|---|
| Matériel | Raspberry Pi 4 ou 5 avec Raspberry Pi OS 64 bits et accès SSH configuré |
| Réseau | IP locale stable ou réservation DHCP pour éviter les changements d’adresse |
| Logiciels | Docker Engine et Docker Compose installés selon la documentation officielle Debian |
Veillez à tenir à jour vos paquets système avec : sudo apt update && sudo apt upgrade -y avant d’installer Docker, afin d’éviter les incompatibilités.
Installation de Docker et préparation du conteneur ntfy
Procédez à l’installation de Docker en suivant attentivement les instructions officielles pour Debian, votre système de base sur Raspberry Pi. Vérifiez ensuite la bonne installation avec :
- docker –version pour la version de Docker Engine,
- docker compose version pour Docker Compose.
Une fois Docker prêt, créez le dossier pour ntfy ainsi que sa configuration :
- mkdir -p ~/services/ntfy/cache ~/services/ntfy/config
- cd ~/services/ntfy
- nano compose.yml
Dans ce fichier YAML, collez la configuration suivante qui définit l’image Docker officielle, les volumes pour la persistance des données, les ports exposés et la timezone :
services:
ntfy:
image: binwiederhier/ntfy:latest
container_name: ntfy
command: serve
environment:
- TZ=Europe/Paris
volumes:
- ./cache:/var/cache/ntfy
- ./config:/etc/ntfy
ports:
- "8080:80"
restart: unless-stopped
Cette configuration cible uniquement un usage local. Pour toute exposition vers Internet, des mécanismes additionnels comme HTTPS et authentification sont indispensables, dont nous parlerons ultérieurement.
Démarrage, test et gestion des notifications avec ntfy sur Docker
Lancez le conteneur en arrière-plan avec la commande docker compose up -d, puis contrôlez l’état avec :
- docker compose ps pour vérifier que le conteneur tourne,
- docker compose logs –tail=30 ntfy pour lire les derniers logs et s’assurer de l’absence d’erreurs.
Accédez ensuite à l’interface web via http://IP_DU_PI:8080, en remplaçant IP_DU_PI par l’adresse locale obtenue avec hostname -I. Vous obtenez ainsi la visibilité directe sur votre serveur ntfy et l’accès aux sujets d’abonnement.
Envoyer une première notification de test
Créez un nom de sujet unique et difficile à deviner, par exemple atelier-maison-7f3k. Pour envoyer une notification simple, lancez cette commande :
curl -d "Test reçu depuis mon Raspberry Pi" http://localhost:8080/atelier-maison-7f3k
Dans l’interface ou l’application ntfy, abonnez-vous à ce sujet pour recevoir instantanément ce message sur vos appareils connectés.
Pour une notification plus riche, incluant un titre et une priorité, utilisez :
curl -H "Title: Sauvegarde terminée" -H "Priority: high" -d "Le disque USB est synchronisé." http://localhost:8080/atelier-maison-7f3k
Intégration dans vos scripts et Home Assistant
Pour automatiser les notifications, ajoutez simplement une commande curl à la fin de vos scripts, par exemple :
curl -H "Title: Tâche Raspberry Pi" -d "Mise à jour terminée sans erreur" http://127.0.0.1:8080/atelier-maison-7f3k
Dans Home Assistant, la communication avec ntfy passe par une requête REST simple ou une intégration dédiée selon votre version. Testez toujours les messages dans un environnement non critique pour vous assurer du bon fonctionnement.
Dépannage et sécurisation du serveur ntfy sur Raspberry Pi
Des difficultés peuvent apparaître lors de l’utilisation. Voici des pistes précises pour résoudre les problèmes fréquents :
- Interface inaccessible : vérifiez que l’IP est correcte, que le conteneur tourne avec docker compose ps et que votre appareil est sur le même réseau local.
- Conteneur qui redémarre : consultez les logs avec docker compose logs ntfy pour identifier souvent une erreur de syntaxe YAML ou un problème de droits.
- Messages non reçus : assurez-vous que le sujet et le serveur spécifiés dans l’application ntfy sont exacts.
- Accès depuis l’extérieur : ne vous contentez pas de rediriger un port. Implémentez une configuration HTTPS, une authentification et un proxy inverse selon la documentation officielle ntfy.
Variante et conseils pour une utilisation adaptée en 2026
Pour une utilisation strictement locale, cette installation simplifiée reste la méthode la plus recommandée. En cas de besoin d’accès à distance, prenez soin d’incorporer :
- une gestion des utilisateurs par authentification,
- la mise en place d’un certificat SSL pour HTTPS,
- un reverse proxy performant comme Nginx ou Traefik pour sécuriser les connexions,
- et une surveillance accrue des logs et alertes.
Si vous cherchez une solution plus poussée avec tableau de bord d’état et monitoring, orientez-vous vers des outils complémentaires comme Uptime Kuma : ntfy demeure une brique essentielle pour les notifications locales et précises.
