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:
@@ -5,7 +5,13 @@
|
|||||||
# Ce domaine doit pointer vers votre serveur et Traefik doit être configuré
|
# Ce domaine doit pointer vers votre serveur et Traefik doit être configuré
|
||||||
DOMAIN=
|
DOMAIN=
|
||||||
|
|
||||||
|
# GID du groupe Docker pour permettre l'accès au socket Docker
|
||||||
|
# Pour obtenir cette valeur, exécutez: getent group docker | cut -d: -f3
|
||||||
|
# Cette valeur est nécessaire pour que les sondes Docker fonctionnent
|
||||||
|
DOCKER_GID=
|
||||||
|
|
||||||
# Notes:
|
# Notes:
|
||||||
# - Le domaine doit être configuré dans votre DNS
|
# - Le domaine doit être configuré dans votre DNS
|
||||||
# - Traefik générera automatiquement un certificat Let's Encrypt
|
# - Traefik générera automatiquement un certificat Let's Encrypt
|
||||||
# - Ne pas inclure http:// ou https://, juste le domaine
|
# - Ne pas inclure http:// ou https://, juste le domaine
|
||||||
|
# - Le DOCKER_GID peut varier selon le serveur, à configurer pour chaque environnement
|
||||||
|
|||||||
34
README.md
34
README.md
@@ -64,6 +64,21 @@ Définissez votre domaine :
|
|||||||
DOMAIN=uptime.votredomaine.com
|
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
|
### 3. Créer le répertoire de données
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
@@ -93,6 +108,7 @@ Accédez à `https://uptime.votredomaine.com` pour configurer votre compte admin
|
|||||||
| Variable | Description | Exemple |
|
| Variable | Description | Exemple |
|
||||||
|----------|-------------|---------|
|
|----------|-------------|---------|
|
||||||
| `DOMAIN` | Nom de domaine pour accéder à Uptime Kuma | `uptime.example.com` |
|
| `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
|
### 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
|
# 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
|
## Commandes utiles
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
|
|||||||
@@ -7,6 +7,8 @@ services:
|
|||||||
- no-new-privileges:true
|
- no-new-privileges:true
|
||||||
cap_drop:
|
cap_drop:
|
||||||
- ALL
|
- ALL
|
||||||
|
group_add:
|
||||||
|
- "${DOCKER_GID}"
|
||||||
networks:
|
networks:
|
||||||
- traefik-net
|
- traefik-net
|
||||||
labels:
|
labels:
|
||||||
|
|||||||
Reference in New Issue
Block a user