---
title: Uptime Kuma
created: 2026-06-06
updated: 2026-06-06
type: app
tags: [catalogue, monitoring, uptime, javascript, auto-hebergement, beginner]
confidence: high
contested: false
sources: [https://selfh.st/apps/?tag=Monitoring, https://github.com/louislam/uptime-kuma]
---
# 📊 Uptime Kuma

> **L'outil de monitoring d'uptime le plus populaire** : simple, beau, complet. Indispensable pour savoir si vos services sont en ligne.

## 📋 Informations Générales

| Champ | Valeur |
| :--- | :--- |
| **Site web** | (GitHub) |
| **GitHub** | [louislam/uptime-kuma](https://github.com/louislam/uptime-kuma) |
| **License** | MIT |
| **Langage** | JavaScript (Node.js) |
| **Étoiles GitHub** | 88k ⭐ |
| **Dernière MAJ** | 2026-06-05 |
| **Catégorie** | [[cat-monitoring|Monitoring]] |

## 📝 Description

**Uptime Kuma** est un **moniteur d'uptime self-hosted** avec une interface moderne. Il supporte :

- ✅ **HTTP(s)** : check une URL, valider le code retour
- ✅ **TCP** : check un port TCP
- ✅ **Ping** : ICMP
- ✅ **DNS** : résolution de domaine
- ✅ **Push monitors** : pour les cron jobs
- ✅ **SQL Server, PostgreSQL, MySQL, MongoDB**
- ✅ **Status pages publiques** (personnalisables)
- ✅ **Notifications** : Telegram, Discord, Slack, Email, 90+ services
- ✅ **Certificats SSL** : alerte avant expiration
- ✅ **Multi-utilisateurs** (auth intégrée)
- ✅ **API** REST
- ✅ **Docker** et **bare-metal**

**Public cible** : **tout le monde**. Du débutant (lance Docker, monitore ton site) à l'entreprise (multi-tenants, status page).

## 🚀 Installation

### Option 1 : Docker Compose (ultra-simple)

```yaml
# docker-compose.yml
version: '3.8'
services:
  uptime-kuma:
    image: louislam/uptime-kuma:1
    container_name: uptime-kuma
    restart: unless-stopped
    ports:
      - "3001:3001"  # Web UI
    volumes:
      - uptime-kuma:/app/data
    labels:
      - "traefik.enable=true"
      - "traefik.http.routers.uptime.rule=Host(`uptime.example.com`)"
      - "traefik.http.routers.uptime.entrypoints=websecure"
      - "traefik.http.routers.uptime.tls.certresolver=letsencrypt"

volumes:
  uptime-kuma:
```

### Option 2 : npm (Node.js)

```bash
git clone https://github.com/louislam/uptime-kuma.git
cd uptime-kuma
npm run setup
npm start
```

## ⚙️ Configuration Initiale

1. **Accéder à l'UI** : `http://IP:3001`
2. **Créer un compte admin**
3. **Ajouter des monitors** :
   - HTTP(s) Monitor : URL + intervalle
   - TCP Monitor : host:port
   - Ping Monitor : IP
4. **Configurer les notifications** : Settings > Notifications
5. **Créer une status page publique** : Status Pages > New

## 🔄 Alternatives

### Open Source
- [[app-netdata]] — Métriques système (pas que uptime)
- [[app-prometheus]] + [[app-glances]] — Stack pro
- **Healthchecks** — Pour cron jobs
- **Statping** — Alternative plus simple (stale)

### Comparaison Uptime Kuma vs autres

| Critère | Uptime Kuma | UptimeRobot | Better Stack |
| :--- | :--- | :--- | :--- |
| Self-hosted | ✅ | ❌ | ❌ (free tier) |
| Prix | Gratuit | Freemium | Freemium |
| Status page | ✅ | ✅ | ✅ |
| Notifications | 90+ | Basique | Moderne |
| SSL check | ✅ | ✅ | ✅ |
| Setup | 5 min | 0 min | 0 min |

**Verdict** : Uptime Kuma est **le roi** de l'uptime monitoring self-hosted. Pas de raison de prendre autre chose sauf besoin spécifique.

### Propriétaires (ce que Kuma remplace)
- **UptimeRobot** (gratuit : 50 checks, 5 min)
- **Pingdom** (payant)
- **Uptime.com**
- **Better Uptime**

## 🔐 Sécurité

- **Auth multi-utilisateurs** avec 2FA (depuis v1.18+)
- **HTTPS recommandé** via [[app-traefik]]
- **API tokens** pour intégrations

## 📚 Ressources

- [GitHub louislam/uptime-kuma](https://github.com/louislam/uptime-kuma)
- [Wiki / FAQ](https://github.com/louislam/uptime-kuma/wiki)
- [Demo live](https://demo.uptime.kuma.pet/)

## Pages Liées
- [[cat-monitoring]] — Catégorie Monitoring
- [[app-traefik]] — Pour exposer en HTTPS
- [[checklist-monitoring-minimal]] — Checklist
- [[monitoring-solo-dev]] — Comparatif
