Installer ntfy sur Raspberry Pi avec Docker : vos notifications maison, pas à pas

Recevez une alerte quand votre Raspberry Pi, Home Assistant ou un script a réellement besoin de vous. Ce guide installe ntfy avec Docker sur Raspberry Pi pour envoyer des notifications vers un téléphone, un PC ou un navigateur, sans service de messagerie tiers.

• Objectif : ntfy local à http://IP_DU_PI:8080.
• Niveau : débutant à intermédiaire, commandes copiables.
• Résultat : un sujet reçoit un message de test et peut servir aux automatisations.

Verdict rapide

ntfy est une brique légère pour centraliser les alertes de services maison. Un Pi 4 ou Pi 5 suffit largement. Commencez sur le réseau local : n’exposez jamais le port 8080 sur Internet sans HTTPS et authentification.

À quoi sert ntfy ?

ntfy reçoit un message HTTP et le redistribue aux clients abonnés à un topic. C’est utile pour une sauvegarde terminée, une température anormale, la présence d’un appareil sur le réseau ou un script de maintenance.

Prérequis

Élément	Conseil
Matériel	Pi 4 ou Pi 5, Raspberry Pi OS 64 bits, SSH
Réseau	IP locale stable ou réservation DHCP
Logiciels	Docker Engine et Docker Compose

Mettez d’abord les paquets à jour :

sudo apt update && sudo apt upgrade -y

Étape 1 — Vérifier Docker

Installez Docker selon la documentation Docker pour Debian, puis vérifiez :

docker --version
docker compose version

Étape 2 — Créer la configuration

mkdir -p ~/services/ntfy/cache ~/services/ntfy/config
cd ~/services/ntfy
nano compose.yml

Collez ensuite :

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

Le volume conserve les données. Cette configuration est volontairement locale ; l’accès extérieur exige une configuration de sécurité complémentaire.

Étape 3 — Démarrer et contrôler

docker compose up -d
docker compose ps
docker compose logs --tail=30 ntfy

Ouvrez http://IP_DU_PI:8080 depuis un appareil du réseau. Remplacez l’adresse par celle du Pi, obtenue avec hostname -I.

Étape 4 — Publier votre première notification

Choisissez un nom de sujet difficile à deviner, par exemple atelier-maison-7f3k, puis envoyez :

curl -d "Test reçu depuis mon Raspberry Pi" http://localhost:8080/atelier-maison-7f3k

Dans l’interface web ou l’application ntfy, abonnez-vous à ce même sujet sur votre serveur local. Pour un message plus précis :

curl -H "Title: Sauvegarde terminée" -H "Priority: high" -d "Le disque USB est synchronisé." http://localhost:8080/atelier-maison-7f3k

Utiliser ntfy depuis un script ou Home Assistant

Cette commande peut être ajoutée à la fin d’un script de sauvegarde, après un test manuel :

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, employez une requête REST ou l’intégration adaptée à votre version, avec l’URL interne de ntfy. Testez toujours une automatisation non critique avant de l’utiliser pour une alerte importante.

Dépannage

1. Interface inaccessible : contrôlez l’IP, docker compose ps et le fait que les appareils sont sur le même réseau.
2. Conteneur qui redémarre : lisez docker compose logs ntfy ; une erreur YAML ou de droits y apparaît généralement.
3. Pas de message sur le téléphone : vérifiez exactement le serveur et le nom du sujet dans l’application.
4. Accès extérieur : utilisez HTTPS, authentification et reverse proxy selon la documentation officielle ; une simple redirection de port est à éviter.

Variantes et limites

Pour un besoin local, cette installation est la plus simple. Une instance exposée doit ajouter utilisateurs, HTTPS et reverse proxy. Pour un tableau de bord d’état, Uptime Kuma est plus approprié ; ntfy est une excellente brique de notification.

Questions fréquentes

ntfy fonctionne-t-il sur Raspberry Pi ?

Oui, l’image Docker est compatible avec les Raspberry Pi récents sous système 64 bits.

Faut-il ouvrir un port sur la box ?

Non pour le réseau local. Un accès extérieur doit être sécurisé avec HTTPS et authentification.

Comment mettre ntfy à jour ?

Dans le dossier du service : docker compose pull && docker compose up -d, puis envoyez un message de test.

Sources officielles

• Documentation ntfy
• Publier avec ntfy
• Docker Engine sur Debian

---

Vincent Vandegans — Passionné de Raspberry Pi, Linux et projets maker, Vincent partage des guides concrets pour construire et administrer sa maison connectée.