Add Docker socket access configuration for Docker monitoring probes

Configure portable Docker GID support to enable Docker container monitoring in Uptime Kuma. The DOCKER_GID environment variable allows the configuration to work across different servers where the docker group ID may vary.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
This commit is contained in:
BeauTroll
2025-12-29 01:06:42 +01:00
parent 7df4500df6
commit ac6eeae2e2
3 changed files with 42 additions and 0 deletions

View File

@@ -64,6 +64,21 @@ Définissez votre domaine :
DOMAIN=uptime.votredomaine.com
```
**Pour activer les sondes Docker** (monitoring de conteneurs Docker), ajoutez également le GID du groupe Docker :
```bash
# Obtenir le GID du groupe docker
getent group docker | cut -d: -f3
```
Ajoutez cette valeur dans le fichier `.env` :
```env
DOCKER_GID=999 # Remplacez par la valeur obtenue
```
> **Note** : Le `DOCKER_GID` peut varier d'un serveur à l'autre. Cette configuration doit être définie pour chaque environnement (dev, staging, prod).
### 3. Créer le répertoire de données
```bash
@@ -93,6 +108,7 @@ Accédez à `https://uptime.votredomaine.com` pour configurer votre compte admin
| Variable | Description | Exemple |
|----------|-------------|---------|
| `DOMAIN` | Nom de domaine pour accéder à Uptime Kuma | `uptime.example.com` |
| `DOCKER_GID` | GID du groupe Docker (requis pour les sondes Docker) | `999` |
### Premier démarrage
@@ -254,6 +270,24 @@ docker exec uptime-kuma curl -f http://localhost:3001 || echo "Healthcheck faile
# Si curl n'est pas disponible, modifier le healthcheck dans docker-compose.yml
```
### Les sondes Docker ne fonctionnent pas (EACCES /var/run/docker.sock)
Si vous voyez l'erreur `connect EACCES /var/run/docker.sock`, c'est un problème de permissions :
```bash
# 1. Obtenir le GID du groupe Docker
getent group docker | cut -d: -f3
# 2. Ajouter cette valeur dans .env
echo "DOCKER_GID=XXX" >> .env # Remplacez XXX par la valeur obtenue
# 3. Redémarrer le container
docker compose down
docker compose up -d
```
**Important** : Le `DOCKER_GID` varie selon le serveur. Configurez-le pour chaque environnement.
## Commandes utiles
```bash