Aller au contenu principal

Installer Uptime Kuma

Installation d'Uptime Kuma sur VPS RedHeberg

Uptime Kuma est un outil de monitoring open-source développé par Louis Lam qui permet de surveiller la disponibilité de vos services. Cette documentation couvre l'installation sur VPS RedHeberg via le pré-install 1-clic recommandé ou manuellement avec Docker.

Prérequis​

  • VPS RedHeberg (recommandé : VPS Game Ryzen START ou supérieur)
  • Accès root SSH
  • Port 3001 ouvert sur votre pare-feu

Méthode 1 : Installation pré-configurée 1-clic (Recommandée)​

RedHeberg propose Uptime Kuma en pré-installation automatique lors de la commande de votre VPS.

Étapes d'installation​

  1. Commandez votre VPS sur l'espace client RedHeberg
  2. Sélectionnez "Uptime Kuma" dans la liste des applications pré-installées
  3. Choisissez votre OS (recommandé : Ubuntu 24.10 ou Debian 12)
  4. Attendez le provisioning (généralement 5-15 minutes)
Avantage du pré-install

L'installation 1-clic configure automatiquement Docker, les dépendances, et lance Uptime Kuma avec les bonnes permissions système.

Une fois votre VPS provisionné, Uptime Kuma sera accessible sur http://YOUR_SERVER_IP:3001.

Méthode 2 : Installation manuelle avec Docker​

Installation de Docker​

# Mise à jour du système
sudo apt update && sudo apt upgrade -y

# Installation des dépendances
sudo apt install -y curl gnupg lsb-release

# Ajout de la clé GPG officielle Docker
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

# Ajout du dépôt Docker
echo "deb [arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# Installation Docker
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io

# Démarrage et activation du service Docker
sudo systemctl start docker
sudo systemctl enable docker

# Ajout de l'utilisateur au groupe docker
sudo usermod -aG docker $USER

Déploiement d'Uptime Kuma​

# Création du répertoire de données
sudo mkdir -p /opt/uptime-kuma
sudo chown $USER:$USER /opt/uptime-kuma

# Lancement du conteneur Uptime Kuma
docker run -d \
  --name uptime-kuma \
  --restart=always \
  -p 3001:3001 \
  -v /opt/uptime-kuma:/app/data \
  louislam/uptime-kuma:1

Vérification de l'installation​

# Vérification du statut du conteneur
docker ps | grep uptime-kuma

# Consultation des logs
docker logs uptime-kuma

# Test de connectivité
curl -I http://YOUR_SERVER_IP:3001

Configuration initiale​

  1. Accédez à l'interface : http://YOUR_SERVER_IP:3001
  2. Créez votre compte administrateur au premier lancement
  3. Définissez un mot de passe robuste
Sécurité importante

Changez immédiatement le mot de passe par défaut et configurez l'authentification deux facteurs si disponible.

Configuration des moniteurs​

Monitor HTTP/HTTPS​

  1. Cliquez sur "Ajouter un nouveau monitor"
  2. Configurez :
    • Type : HTTP(s)
    • Nom convivial : Mon Site Web
    • URL : https://monsite.com
    • Intervalle : 60 secondes
    • Timeout : 48 secondes

Monitor TCP​

# Exemple : monitoring port SSH
Type: Port TCP
Nom: SSH Server
Nom d'hôte: YOUR_SERVER_IP
Port: 22
Intervalle: 300 secondes

Monitor Ping​

# Monitoring connectivité réseau
Type: Ping
Nom: Connectivité Serveur
Nom d'hôte: YOUR_SERVER_IP
Intervalle: 120 secondes

Configuration des notifications​

Notification Discord​

  1. Créez un webhook Discord dans votre serveur
  2. Dans Uptime Kuma, allez à Paramètres > Notifications
  3. Ajoutez une notification Discord :
    • URL du webhook : votre URL webhook Discord
    • Nom d'utilisateur : UptimeKuma
    • Mentionner ici : @everyone (optionnel)

Notification Email​

# Configuration SMTP
Type: Email (SMTP)
Nom amical: Alertes Monitoring
Serveur SMTP: smtp.gmail.com
Port: 587
Sécurité: STARTTLS
Nom d'utilisateur: votre-email@gmail.com
Mot de passe: mot-de-passe-application
De: monitoring@votre-domaine.com
À: admin@votre-domaine.com

Configuration reverse proxy Nginx​

Pour utiliser un nom de domaine avec HTTPS :

# Installation Nginx
sudo apt install -y nginx

# Configuration du virtual host
sudo tee /etc/nginx/sites-available/uptime-kuma << 'EOF'
server {
    listen 80;
    server_name monitoring.votre-domaine.com;
    
    location / {
        proxy_pass http://127.0.0.1:3001;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_cache_bypass $http_upgrade;
    }
}
EOF

# Activation du site
sudo ln -s /etc/nginx/sites-available/uptime-kuma /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx
Protection Anti-DDoS

Les VPS RedHeberg bénéficient de la protection Anti-DDoS RedHeberg + Netrix, protégeant automatiquement votre instance Uptime Kuma contre les attaques.

Maintenance et sauvegarde​

# Sauvegarde des données
sudo tar -czf uptime-kuma-backup-$(date +%Y%m%d).tar.gz /opt/uptime-kuma/

# Mise à jour du conteneur
docker pull louislam/uptime-kuma:1
docker stop uptime-kuma
docker rm uptime-kuma
docker run -d \
  --name uptime-kuma \
  --restart=always \
  -p 3001:3001 \
  -v /opt/uptime-kuma:/app/data \
  louislam/uptime-kuma:1

Votre instance Uptime Kuma est maintenant opérationnelle sur votre VPS RedHeberg avec monitoring complet de vos services et notifications configurées.