Dépannage de Gladys Assistant : problèmes fréquents et solutions
Cette page rassemble les problèmes les plus fréquents avec Gladys Assistant et comment les résoudre. Si le vôtre n'y est pas, les logs et le forum sont l'étape suivante.
Commencez par les logs
La plupart des problèmes laissent une trace dans les logs de Gladys : un message d'erreur nomme en général l'intégration ou l'appareil en cause. Vous pouvez les télécharger en un clic depuis Paramètres > Système > Télécharger les logs, ou les lire en ligne de commande si l'interface ne s'ouvre pas. Voir comment télécharger les logs de Gladys.
Si vous avez installé Gladys avec Gladys Assistant OS, sudo gladys-diagnostics affiche aussi l'état de la machine : réseau, disque, Docker et Gladys. Lancez-le en SSH, ou sur le mini-PC lui-même après avoir appuyé sur Ctrl+Alt+F2 pour obtenir une invite de connexion.
Installation
Le mini-PC ne démarre pas sur la clé USB
L'image de Gladys Assistant OS doit être écrite sur la clé USB avec un outil comme balenaEtcher : copier le fichier .iso sur la clé ne fonctionne pas. Ensuite, dans les réglages du BIOS (en général avec Suppr ou F2 au démarrage), vérifiez que l'ordinateur démarre en mode UEFI (et non « Legacy » ou « CSM »), et placez la clé USB en premier dans l'ordre de démarrage. S'il refuse toujours de démarrer, désactivez le Secure Boot dans ces mêmes réglages.
Gladys ne s'ouvre pas après l'installation
Avec Gladys Assistant OS, l'écran du mini-PC indique où en est l'installation. Au premier démarrage, il télécharge Gladys, ce qui peut prendre un moment selon votre connexion Internet : attendez que l'écran affiche Gladys Assistant est prêt. S'il affiche Connexion Internet requise, vérifiez le câble Ethernet et votre box : l'installation reprend toute seule. S'il affiche La configuration ne peut pas continuer, voir la section « En cas de problème » du guide.
Avec Docker, vérifiez, dans cet ordre, que le conteneur tourne (sudo docker ps), qu'aucun autre serveur web n'utilise déjà le port 80, et qu'aucun pare-feu ne le bloque. Le guide d'installation Docker détaille chaque étape.
gladysassistant.local ne s'ouvre pas
Certains réseaux bloquent le protocole mDNS derrière ce nom : certaines versions d'Android, les réseaux invités, les box avec isolation des clients. Utilisez plutôt l'adresse IP de la machine qui fait tourner Gladys, par exemple http://192.168.1.20. Avec Gladys Assistant OS, cette adresse est affichée sur l'écran du mini-PC. Voir que faire si gladysassistant.local ne s'ouvre pas.
Connexion
J'ai oublié mon mot de passe
Sur la page de connexion, cliquez sur J'ai oublié mon mot de passe et saisissez votre email. Gladys vous envoie un lien de réinitialisation, ou un code à usage unique, par Telegram ou Nextcloud Talk si vous avez configuré l'un des deux.
Sinon, le lien ou le code est écrit dans les logs de Gladys. Lancez ceci sur la machine qui fait tourner Gladys :
sudo docker logs gladys 2>&1 | grep "Forgot password"
Si vous avez fait trop d'essais, attendez 30 minutes ou redémarrez Gladys avec sudo docker restart gladys. Un autre administrateur peut aussi réinitialiser votre mot de passe depuis Paramètres > Utilisateurs.
Il s'agit du mot de passe de votre Gladys à la maison. Pour votre compte Gladys Plus, utilisez J'ai oublié mon mot de passe sur plus.gladysassistant.com.
Mon code de double authentification Gladys Plus est refusé, ou j'ai perdu mon téléphone
Vérifiez d'abord que votre téléphone règle sa date et son heure automatiquement : si son horloge décale de plus de 30 secondes environ, tous les codes qu'il génère sont refusés. Vous avez changé de téléphone, ou perdu votre application d'authentification et vos codes de récupération ? Depuis Gladys 5.3.1, vous pouvez récupérer l'accès à votre compte par vous-même, sans écrire au support. Voir résoudre les problèmes de double authentification.
Mises à jour
Comment mettre à jour Gladys ?
Avec Gladys Assistant OS, vous n'avez rien à faire : Gladys se met à jour toute seule dès qu'une nouvelle version sort. Avec Docker, si vous avez lancé Watchtower comme indiqué dans le guide d'installation, Gladys se met aussi à jour toute seule.
Vous pouvez aussi mettre à jour manuellement : dans Paramètres > Système, cliquez sur Vérifier les mises à jour, puis sur Mettre à jour maintenant quand une nouvelle version est disponible.
La mise à jour indique que mon conteneur utilise une « image figée »
Votre conteneur a été créé avec une version fixe, comme gladysassistant/gladys:v4.80.0, qui ne reçoit jamais de mise à jour. Recréez-le avec l'image gladysassistant/gladys:v5, en gardant les options de votre conteneur actuel : le même dossier de données, le même port et les mêmes variables d'environnement. Sur un NAS Synology, par exemple, elles diffèrent de la commande standard.
- Supprimez le conteneur avec
sudo docker rm -f gladys. Vos données restent dans leur dossier sur la machine (/var/lib/gladysassistantavec la commande d'installation). - Relancez-le avec les mêmes options, et
gladysassistant/gladys:v5comme image.
Avec Docker Compose, indiquez image: gladysassistant/gladys:v5 dans votre fichier, puis lancez sudo docker compose -f gladys-compose.yml up -d (avec le nom de votre fichier).
La mise à jour échoue faute d'espace disque
Docker garde les images des versions précédentes. Supprimez celles qu'aucun conteneur n'utilise avec sudo docker image prune -a, puis réessayez.
Appareils et scènes
Mon dongle Zigbee n'est pas détecté, ou Zigbee2MQTT ne démarre pas
Dans Intégrations > Zigbee2MQTT > Configuration, Gladys liste les ports USB avec le nom de l'appareil branché sur chacun, et présélectionne le port et le modèle des dongles les plus courants. Si votre dongle n'apparaît pas dans la liste, vérifiez que la machine le voit avec ls /dev/serial/by-id/. Si Zigbee2MQTT ne passe pas au vert, Gladys vous indique pourquoi sur cette même page : voir les erreurs Zigbee2MQTT les plus fréquentes et leurs solutions. Si Gladys tourne dans une machine virtuelle, le dongle doit lui être transmis (voir le guide Proxmox).
Un capteur n'affiche plus sa valeur sur le tableau de bord
Le tableau de bord masque par défaut les valeurs de plus de 48 heures, pour que vous ne vous fiiez pas à un capteur qui ne remonte plus rien. Vérifiez les piles et la portée du capteur. S'il ne remonte que rarement par conception, augmentez le Délai avant expiration d'un état dans Paramètres > Système.
Mes scènes programmées se lancent à la mauvaise heure
Les scènes programmées utilisent le fuseau horaire de Gladys : vérifiez-le dans Paramètres > Système > Fuseau horaire.
Données et sauvegardes
Le disque de ma machine se remplit
Gladys conserve l'historique de chaque capteur. Dans Paramètres > Système, réduisez Conserver l'historique des états des appareils, et supprimez les anciennes images Docker avec sudo docker image prune -a.
Comment restaurer une sauvegarde ?
Avec Gladys Plus, Gladys est sauvegardée tous les jours, de manière chiffrée. Pour restaurer une sauvegarde, ouvrez Paramètres > Sauvegardes et cliquez sur Restaurer. Sur une nouvelle installation, choisissez Restauration Gladys Plus sur l'écran d'accueil. Dans les deux cas, il vous faut votre clé de sauvegarde : elle est affichée dans Paramètres > Gladys Plus de votre instance actuelle, notez-la donc avant d'en avoir besoin.
Vous remplacez la machine qui fait tourner Gladys ? Suivez le guide pour changer de machine : il liste ce qu'il faut noter avant de basculer, et récupère vos appareils Zigbee et Matter sans les réappairer.
Toujours bloqué ?
Créez un sujet sur le forum, décrivez ce que vous avez fait et ce qui se passe, et joignez vos logs. Avec Gladys Assistant OS, ajoutez aussi la sortie de sudo gladys-diagnostics : elle ne contient ni mot de passe ni secret. La communauté vous aidera à trouver la cause.
Avant de publier, relisez vos logs : si vous avez réinitialisé votre mot de passe récemment, retirez-en le lien ou le code de réinitialisation, ainsi que tout ce que vous ne voulez pas partager publiquement.