Surveiller la disponibilite de ses services sur VPS Linux avec Uptime Kuma

Uptime Kuma : monitoring de disponibilité sur VPS Linux

Uptime Kuma est un outil de surveillance de disponibilité open source que tout administrateur installe sur son serveur VPS Linux ou serveur dédié via SSH. Développé par Louis Lam, il surveille vos services HTTP/HTTPS, TCP, DNS, WebSocket, Ping et conteneurs Docker, puis envoie des alertes Telegram, Discord ou Email (SMTP). Contrairement aux solutions cloud, vous administrez Uptime Kuma sur votre propre infrastructure sous Ubuntu ou Debian, sans limite de moniteurs ni abonnement mensuel.

Avantages d'héberger Uptime Kuma sur votre serveur VPS :

• Surveiller la disponibilité de vos sites web, API et serveurs de jeu (FiveM, Minecraft)
• Recevoir une alerte en moins de 20 secondes sur Telegram après une panne ou une coupure réseau
• Publier une page de statut sur votre nom de domaine pour informer vos utilisateurs
• Contrôler l'expiration des certificats SSL et redémarrer les services défaillants
• Conserver les sauvegardes des configurations de moniteurs sur le SSD du serveur

Installer Uptime Kuma avec Docker sur VPS Linux

La méthode recommandée utilise Docker : le daemon Docker administre le cycle de vie du conteneur, les sauvegardes automatiques et les mises à jour sans modifier la configuration système du serveur. Installez d'abord Docker en suivant notre guide Installer Docker sur un VPS. Connectez-vous en SSH à votre serveur Ubuntu ou Debian, puis lancez le conteneur :

docker run -d --restart=always \
  -p 127.0.0.1:3001:3001 \
  -v uptime-kuma:/app/data \
  --name uptime-kuma \
  louislam/uptime-kuma:2

L'option -p 127.0.0.1:3001:3001 lie le port à l'interface localhost du serveur VPS : le firewall (UFW ou nftables) filtre les connexions entrantes depuis Internet. Le volume uptime-kuma:/app/data stocke les données, les config et les sauvegardes du daemon sur le SSD. Vérifiez que le conteneur est actif :

docker ps | grep uptime-kuma

Exposer le panel via Nginx en HTTPS

Pour accéder au panel depuis Internet avec un certificat SSL, configurez Nginx comme reverse proxy devant le port 3001 sur votre serveur dédié ou VPS Linux. Créez la config dans /etc/nginx/sites-available/uptime-kuma :

server {
    listen 80;
    server_name status.mondomaine.com;

    location / {
        proxy_pass http://127.0.0.1:3001;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

Activez la configuration et installez un certificat Let's Encrypt :

sudo ln -s /etc/nginx/sites-available/uptime-kuma /etc/nginx/sites-enabled/
sudo nginx -t && sudo systemctl reload nginx
sudo certbot --nginx -d status.mondomaine.com

Consultez notre guide Configurer Nginx comme reverse proxy sur un VPS Linux pour les configurations avancées du serveur Web et la gestion des connexions WebSocket.

Installer Uptime Kuma sans Docker

Si le daemon Docker n'est pas disponible sur votre serveur VPS Ubuntu ou Debian, installez Uptime Kuma directement via SSH avec Node.js et npm. Des scripts shell permettent d'automatiser les sauvegardes et le redémarrage du service :

sudo apt install nodejs npm git -y
git clone https://github.com/louislam/uptime-kuma.git
cd uptime-kuma
npm run setup

Pour maintenir le service actif après déconnexion SSH et redémarrer automatiquement l'application au démarrage du serveur, créez un service systemd. Consultez notre guide Créer un service systemd pour son serveur de jeu Linux pour la configuration du daemon systemd et les options de restart sur crash.

Ajouter des moniteurs : HTTP, TCP, DNS, Docker

Dans le panel Uptime Kuma, cliquez sur Add New Monitor pour configurer un moniteur :

• HTTP(s) : vérifie qu'une URL répond avec un code 200, adapté aux sites web, API REST et panels hébergés sur votre serveur VPS.
• TCP Port : teste les connexions vers un port depuis l'extérieur, surveille un serveur FiveM (30120) ou Minecraft (25565) sur votre serveur dédié.
• Ping : mesure la disponibilité et la latence ICMP de l'adresse IP du serveur.
• DNS Record : vérifie les enregistrements DNS de vos domaines.
• Docker Container : surveille l'état des conteneurs Docker sur votre serveur VPS Linux.

L'intervalle minimum est de 20 secondes. Uptime Kuma envoie une alerte à chaque panne et à chaque rétablissement de service. Pour surveiller les ressources système (CPU, RAM, espace disque SSD), combinez avec notre guide Configurer des alertes de monitoring sur un VPS Linux.

Configurer les alertes : Telegram, Discord, Email

Dans Settings > Notifications, configurez vos canaux d'alertes :

• Telegram : créez un bot via BotFather, renseignez le token API et l'ID de chat
• Discord : créez un webhook dans les paramètres de votre serveur Discord
• Email (SMTP) : renseignez l'adresse et le port du serveur SMTP de votre hébergeur

Plus de 90 canaux de notification sont disponibles pour administrer vos alertes dans Uptime Kuma.

Page de statut et surveillance des certificats SSL

Dans Status Page, créez une page de statut publique sur votre serveur Linux. Associez-la à votre nom de domaine pour informer vos utilisateurs en temps réel de l'état de vos services. Un panneau de statut public renforce la confiance des utilisateurs de votre hébergement.

Uptime Kuma affiche la date d'expiration des certificats SSL de chaque moniteur HTTPS. Combinez avec notre guide Vérifier l'expiration d'un certificat TLS avec openssl s_client pour contrôler vos certificats depuis la ligne de commande de votre serveur dédié.

Héberger Uptime Kuma sur un VPS ElypseCloud

Uptime Kuma est léger et s'administre facilement sur un VPS Linux. Les VPS Linux ElypseCloud fonctionnent sous Ubuntu et Debian avec accès root admin inclus, Docker préinstallable, SSD NVMe et firewall configurable : idéal pour héberger votre serveur de monitoring en continu sans surcharge du serveur principal. Activez les sauvegardes automatiques pour préserver vos config de moniteurs et alertes.