Dépannage¶

Commencez par Paramètres → Test de connexion : il vérifie la connexion étape par étape et indique quoi faire quand une étape échoue. Les problèmes les plus courants sont décrits ci-dessous, avec le message affiché par l'application.

Installation et serveur¶

« Cannot connect to the Docker daemon » ou « docker: command not found »¶

Docker Desktop n'est pas lancé (macOS, Windows) ou le service Docker est arrêté (Linux). Lancez-le, attendez que le moteur tourne, puis relancez la commande.

Windows : « WSL 2 installation is incomplete »¶

WSL 2 ou la virtualisation n'est pas activé. Suivez le guide WSL de Microsoft, redémarrez, puis relancez Docker Desktop.

Linux : « permission denied » sur le socket Docker¶

Votre utilisateur n'a pas de droits sur Docker. Utilisez sudo, ou suivez les étapes post-installation.

La page ne s'ouvre pas, ou « Le serveur local ne répond pas »¶

ROMKADE Manager ne tourne pas. Dans le dossier romkade :

docker compose ps
docker compose up -d

Si le service redémarre sans cesse, docker compose logs romkade en indique la raison. À partir du code source : relancez ./run.sh.

Le port 8765 est déjà utilisé¶

docker compose up échoue avec « port is already allocated » : un autre programme utilise le port. Lancez ROMKADE Manager sur un autre port, par exemple ROMKADE_PORT=8780 docker compose up -d (PowerShell : $env:ROMKADE_PORT=8780; docker compose up -d), puis ouvrez http://localhost:8780.

À partir du code source, run.sh s'arrête et indique quel programme occupe le port, en général une instance précédente : kill $(lsof -t -iTCP:8765 -sTCP:LISTEN), puis ./run.sh.

« manifest unknown » ou « denied » au téléchargement de l'image¶

Le nom ou la version de l'image dans compose.yaml est incorrect, ou le fichier n'a pas été téléchargé depuis la version officielle. Téléchargez-le de nouveau avec la commande de la page Installation.

Connexion¶

La console est injoignable¶

« Console injoignable ». Vérifiez que :

la console est allumée, le Wi-Fi activé, et qu'elle n'est pas en veille ;
l'ordinateur et la console sont sur le même réseau (pas un réseau invité) ;
l'adresse indiquée dans Paramètres → Connexion est toujours celle de la console : elle peut changer après un redémarrage de la box.

macOS bloque l'accès au réseau local¶

« macOS bloque l'accès au réseau local pour le serveur Game Manager », ou « No route to host » alors que la console répond. macOS interdit à l'application qui fait tourner ROMKADE Manager de joindre le réseau local.

Ouvrez Réglages Système → Confidentialité et sécurité → Réseau local.
Activez Docker (installation Docker), ou l'application qui a lancé ./run.sh (Terminal, iTerm, VS Code…).
Relancez : quittez et rouvrez Docker Desktop, ou Ctrl+C puis ./run.sh.

À partir du code source, le même symptôme apparaît avec le Python de Homebrew : utilisez le Python de python.org.

Windows : la console est injoignable avec Docker¶

Le Pare-feu Windows peut bloquer Docker sur le type de réseau utilisé. Vérifiez que votre réseau Wi-Fi est défini comme Privé, et que Docker Desktop est autorisé pour les réseaux privés dans les réglages du pare-feu.

La console refuse les connexions SSH¶

« La console répond mais refuse la connexion […] : SSH n'est pas activé ». La console répond, mais SSH est désactivé : activez SSH dans les réglages de la console, ou vérifiez le port dans Paramètres → Connexion.

Le mot de passe est refusé¶

« Authentification SSH refusée par la console ». Mettez à jour le mot de passe dans Paramètres → Connexion (Remplacer le mot de passe). Avec une clé SSH, vérifiez que sa clé publique figure dans ~/.ssh/authorized_keys sur la console.

La clé de la console a changé¶

« La clé d'hôte ne correspond pas à celle enregistrée. Connexion bloquée. ». L'appareil à cette adresse présente une clé différente de celle que vous avez approuvée. C'est normal après une réinstallation du firmware ou un changement de carte ; sinon, il peut s'agir d'un autre appareil. Vérifiez de nouveau l'empreinte avec ssh-keyscan (voir Connexion) avant d'approuver la nouvelle clé.

« Le dossier des ROMs est introuvable » ou « Le dossier des ROMs est vide »¶

Vérifiez que la carte est en place, puis le chemin indiqué dans Paramètres → Connexion. Paramètres → Système propose le dossier trouvé sur la console. Si le dossier est vide alors que le catalogue contient des jeux, la synchronisation est refusée et rien ne change.

Jeux¶

« Lancement à distance impossible »¶

Sur Anbernic, le lancement à distance nécessite le Stock OS Mod. Sur les autres firmwares, vérifiez ce que permet le profil dans Paramètres → Système et sur Consoles compatibles.

Les boutons de la console ne contrôlent plus le jeu¶

Le joueur 1 est encore attribué à une manette qui n'est pas branchée. Ouvrez Manettes et cliquez sur Utiliser les boutons de la console.

Pas de jaquettes¶

« Banque de jaquettes injoignable » : l'ordinateur n'a pas accès à Internet. Les jaquettes déjà téléchargées restent disponibles. Certains jeux n'ont pas de jaquette dans la collection libretro : passez Images sur Images de la carte dans la bibliothèque.

« Pas assez de place sur la carte »¶

La copie nécessite la taille des fichiers plus une marge de 256 Mo. Retirez des fichiers de la liste ou libérez de la place sur la carte.

Sauvegardes¶

« Un jeu tourne sur la console »¶

La restauration ou la suppression d'une sauvegarde est refusée pendant une partie, car le jeu réécrirait le fichier en quittant. Quittez d'abord le jeu.

Bluetooth¶

Une manette ne s'appaire pas¶

Les manettes récentes (Xbox, 8BitDo…) ne s'appairent que pendant une recherche active. Mettez la manette en mode appairage, cliquez sur Rechercher des appareils, puis sur Appairer et connecter. Si elle est appairée mais ne répond pas, réveillez-la (bouton Xbox ou Home) et cliquez sur Connecter.

Les appareils ont disparu après un redémarrage¶

Le firmware Anbernic efface les appairages Bluetooth à chaque démarrage. Appairez-les de nouveau depuis la page Bluetooth.

Pas de son sur l'enceinte Bluetooth¶

Cliquez sur Envoyer le son des jeux ici à côté de l'enceinte, puis lancez le jeu depuis ROMKADE Manager : les jeux lancés depuis le menu de la console continuent d'utiliser ses haut-parleurs.

Recherche¶

La recherche ne tolère pas les fautes de frappe¶

Typesense ne tourne pas, c'est donc la recherche intégrée qui est utilisée. Démarrez Docker Desktop, puis relancez ROMKADE Manager.

Toujours bloqué ?¶

Consultez À propos pour signaler le problème. Indiquez le message affiché, le modèle de la console et son firmware.