Problèmes courants rencontrés avec YAMS et solutions 🔧

Problèmes liés à Docker

Permission Denied Errors 🚫

Vous obtenez cette erreur lorsque vous exécutez des commandes YAMS ?

permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock

Solution rapide :

# Ajoutez vous au groupe docker
sudo usermod -aG docker $USER

# Déconnectez-vous et reconnectez-vous, ou lancez la commande :
newgrp docker

Toujours des problèmes ?

Vérifiez l’appartenance au groupe :
```
groups $USER
```
Vous devriez voir “docker” dans la liste.
Vérifiez les permissions du socket :
```
ls -l /var/run/docker.sock
```
Ça devrait afficher : srw-rw---- 1 root docker
Vérifiez le service Docker :
```
systemctl status docker
```

Problèmes de VPN

Gluetun ne se connecte pas 🔌

Si votre VPN ne fonctionne pas, nous allons résoudre le problème étape par étape :

Vérifiez les logs de Gluetun
```
docker logs -n 100 gluetun
```
Messages d’erreur courants :
- “Authentication failed”: Vérifiez vos identifiants VPN
- “Network unreachable”: Vérifiez votre connexion internet
- “No such host”: Problèmes de DNS. Vérifiez les paramètres de votre réseau

Vérifiez les paramètres VPN

# Dans votre fichier .env
VPN_ENABLED=y
VPN_SERVICE=votre_fournisseur
VPN_USER=votre_identifiant
VPN_PASSWORD=votre_mot_de_passe

Testez la connexion VPN
```
yams check-vpn
```
Problèmes spécifiques aux fournisseurs :
- ProtonVPN : Veillez à utiliser les bons identifiants (Nom d’utilisateur OpenVPN / IKEv2).
- Mullvad : Le numéro de compte doit comporter exactement 16 chiffres
- NordVPN : Utilisez votre token et non votre mot de passe habituel

Corrections rapides du VPN 🛠️

Réinitialisez la connexion VPN
```
yams restart
```
Forcez la régénération du conteneur
```
yams destroy
yams start
```
Vérifiez les paramètres du réseau
```
docker network ls
```

Problèmes liés aux clients de téléchargement

qBittorrent n’est pas accessible 🔒

Vérifiez si le VPN est activé
- Vérifiez votre Configuration VPN
- Lancez un test du VPN :
```
yams check-vpn
```
Vérifiez le mappage des ports
```
docker ps | grep qbittorrent
```
Le port 8081 devrait être affiché

Vérifiez le mode réseau Dans docker-compose.yaml:

qbittorrent:
    network_mode: "service:gluetun"

Vérifiez les logs
```
docker logs qbittorrent
```

Problème de connexion à SABnzbd 📡

Vérifiez le statut du service
```
docker ps | grep sabnzbd
```

Vérifiez la configuration Look for:

sabnzbd:
    ports:
        - 8080:8080

Consultez les logs
```
docker logs sabnzbd
```

Problèmes liés au serveur multimédia

Jellyfin/Emby/Plex ne trouve pas les médias 📺

Vérifiez les permissions
```
ls -l /your/media/directory
```
Should be owned by PUID:PGID from your .env file
Vérifiez les points de montage
```
docker inspect your-media-server
```
Look for “Mounts” section
Erreur de chemins
- Dans le conteneur : /data/movies, /data/tshows
- Sur votre système : Votre chemin MEDIA_DIRECTORY
Scan des bibliothèques
- Déclenchez un scan manuel dans l’interface web
- Vérifiez les chemins d’accès aux bibliothèques dans les paramètres

Problèmes de performances

Utilisation excessive du CPU 🔥

Vérifiez les statistiques des conteneurs
```
docker stats
```
Vérifiez les ressources du système
```
top
# or
htop
```
Recherche de problèmes dans les logs
```
docker logs --tail 100 container-name
```

Problèmes de mémoire 💾

Vérifiez la mémoire disponible
```
free -h
```

Surveillez la mémoire des conteneurs

docker stats --format "table {{.Name}}\t{{.MemUsage}}"

Fixez des restrictions aux conteneurs In docker-compose.yaml:

services:
    your-service:
        mem_limit: 1g

Encore besoin d’aide ? 🆘

Toujours bloqué ? Nous sommes là pour vous aider !

Vérifiez les logs détaillés

# Logs de tous les conteneurs
docker-compose logs

# Logs d'un conteneur spécifique
docker-compose logs container-name

Ressources communautaires
Remonter un problème :
- Consultez nos Issues GitLab existantes
- Fournissez vos logs et votre configuration lorsque vous ouvrez un ticket

N’oubliez pas : La plupart des problèmes ont des solutions simples ! Si vous êtes bloqué, notre communauté est là pour vous aider ! 💪

FAQ

Erreurs courantes