Pourquoi self-heberger Uptime Kuma sur un VPS
Les services de monitoring SaaS facturent souvent au nombre de moniteurs ou a la frequence de verification, et plafonnent l'intervalle a 1 ou 5 minutes sur les offres gratuites. En deployant Uptime Kuma sur votre propre VPS, vous supervisez un nombre illimite de sites, d'API, de ports TCP, de conteneurs Docker ou de serveurs DNS, avec des intervalles aussi courts que 20 secondes. Heberger la sonde sur un VPS distinct de vos serveurs de production est un atout : si votre serveur applicatif tombe, le VPS de monitoring reste debout et declenche l'alerte. Uptime Kuma propose en plus une page de statut publique que vous pouvez exposer a vos clients, et plus de 90 canaux de notification (Telegram, e-mail, Discord, webhook). Tout reste sur votre infrastructure, sans envoyer vos URL internes a un tiers.
Les benefices concrets de ce template
- Moniteurs illimites : HTTP(s), TCP, ping, DNS, conteneurs Docker, certificats SSL et mots-cles de page.
- Alertes multi-canaux (Telegram, e-mail, Discord, Slack, webhook) avec plus de 90 integrations.
- Page de statut publique personnalisable a partager avec vos clients ou votre equipe.
- Surveillance de l'expiration des certificats SSL pour ne plus jamais etre pris au depourvu.
- Historique et statistiques d'uptime conserves localement, sans retention payante.
- Verifications jusqu'a toutes les 20 secondes, impossible sur la plupart des offres gratuites.
Prerequis pour l'heberger
Uptime Kuma est tres frugal : un VPS 1 vCPU avec 512 Mo a 1 Go de RAM suffit largement pour surveiller plusieurs dizaines de moniteurs. La base de donnees SQLite embarquee occupe peu d'espace, comptez 2 a 5 Go de disque selon l'historique conserve. Il vous faut Docker installe, un nom de domaine ou sous-domaine (status.mondomaine.ma) pointe sur le VPS, et les ports 80/443 ouverts pour le reverse proxy et le SSL. Pour une supervision fiable, hebergez de preference Uptime Kuma sur un VPS distinct de vos serveurs de production.
Deployer Uptime Kuma avec Docker et SSL
Creer le volume et lancer le conteneur
Sur le VPS, creez un volume persistant puis demarrez le conteneur : docker run -d --restart=always -p 3001:3001 -v uptime-kuma:/app/data --name uptime-kuma louislam/uptime-kuma:1. L'interface est accessible sur le port 3001.
Configurer le compte administrateur
Ouvrez http://IP_DU_VPS:3001 et creez le compte admin a la premiere connexion. Choisissez un mot de passe fort : cette interface aura acces a toutes vos URL surveillees.
Mettre un reverse proxy et le SSL devant
Configurez Nginx ou Caddy pour exposer status.mondomaine.ma vers localhost:3001. Avec Caddy, deux lignes suffisent pour obtenir un certificat Let's Encrypt automatique : status.mondomaine.ma { reverse_proxy localhost:3001 }.
Ajouter vos premiers moniteurs
Creez des moniteurs HTTP(s) pour vos sites, un moniteur TCP pour votre base de donnees, un check SSL pour surveiller l'expiration des certificats et un mot-cle pour detecter les pages d'erreur servies en HTTP 200.
Brancher les notifications et la page de statut
Dans Parametres > Notifications, ajoutez Telegram ou e-mail et testez l'envoi. Activez ensuite une page de statut publique regroupant vos services clients, avec un nom de domaine dedie si besoin.
Pour eviter les fausses alertes lors d'un micro-incident reseau, configurez le champ Retries (par exemple 3 echecs consecutifs avant alerte) et un Heartbeat Interval adapte. Combinez-le avec une notification de groupe : Uptime Kuma peut envoyer un message agrege plutot qu'une alerte par moniteur, ce qui evite de noyer votre canal Telegram lors d'une panne reseau globale qui fait tomber dix services d'un coup.
La documentation officielle
Pour la configuration avancée et les options propres à l'outil, référez-vous à la documentation officielle de Uptime Kuma. Ce guide couvre la mise en ligne sur VPS ; la doc éditeur reste la référence pour les réglages fins, les mises à jour majeures et les cas d'usage spécifiques.
