Solución de problemas¶
Empieza por Ajustes → Prueba de conexión: comprueba la conexión paso a paso y te dice qué hacer cuando falla un paso. Abajo tienes los problemas más habituales, con el mensaje que muestra la aplicación.
Instalación y servidor¶
«Cannot connect to the Docker daemon» o «docker: command not found»¶
Docker Desktop no está en marcha (macOS, Windows) o el servicio Docker está detenido (Linux). Inícialo, espera a que el motor esté en marcha y vuelve a ejecutar el comando.
Windows: «WSL 2 installation is incomplete»¶
WSL 2 o la virtualización no están activados. Sigue la guía de WSL de Microsoft, reinicia y vuelve a iniciar Docker Desktop.
Linux: «permission denied» en el socket de Docker¶
Tu usuario no tiene permisos sobre Docker. Usa sudo, o sigue los
pasos posteriores a la instalación.
La página no se abre, o «El servidor local no responde»¶
ROMKADE Manager no está en marcha. En la carpeta romkade:
docker compose ps
docker compose up -d
Si el servicio no deja de reiniciarse, docker compose logs romkade muestra por qué. Desde el código fuente: vuelve a
iniciar ./run.sh.
El puerto 8765 ya está en uso¶
docker compose up falla con «port is already allocated»: otro programa usa el puerto. Inicia ROMKADE Manager en otro,
por ejemplo ROMKADE_PORT=8780 docker compose up -d (PowerShell: $env:ROMKADE_PORT=8780; docker compose up -d),
y abre http://localhost:8780.
Desde el código fuente, run.sh se detiene e indica qué programa ocupa el puerto, normalmente una instancia anterior:
kill $(lsof -t -iTCP:8765 -sTCP:LISTEN) y luego ./run.sh.
«manifest unknown» o «denied» al descargar la imagen¶
El nombre o la versión de la imagen en compose.yaml son incorrectos, o el archivo no se descargó de la versión
oficial. Vuelve a descargarlo con el comando de la página Instalación.
Conexión¶
La consola es inaccesible¶
«Consola inaccesible». Comprueba que:
- la consola está encendida, con el Wi-Fi activado y no en reposo;
- el ordenador y la consola están en la misma red (no en una red de invitados);
- la dirección de Ajustes → Conexión sigue siendo la de la consola: puede cambiar tras reiniciarse el router.
macOS bloquea el acceso a la red local¶
«macOS bloquea el acceso a la red local para el servidor de Game Manager», o «No route to host» mientras la consola responde. macOS impide que la aplicación que ejecuta ROMKADE Manager acceda a la red local.
- Abre Ajustes del Sistema → Privacidad y seguridad → Red local.
- Activa Docker (instalación con Docker), o la aplicación que inició
./run.sh(Terminal, iTerm, VS Code…). - Reinicia: cierra y vuelve a abrir Docker Desktop, o Ctrl+C y luego
./run.sh.
Desde el código fuente, el mismo síntoma aparece con el Python de Homebrew: usa el Python de python.org.
Windows: la consola es inaccesible con Docker¶
El Firewall de Windows puede bloquear Docker en el tipo de red en uso. Comprueba que tu red Wi-Fi está configurada como Privada y que Docker Desktop está permitido para las redes privadas en los ajustes del firewall.
La consola rechaza las conexiones SSH¶
«La consola rechaza las conexiones SSH». La consola responde, pero SSH está desactivado: activa SSH en los ajustes de la consola o comprueba el puerto en Ajustes → Conexión.
La contraseña es rechazada¶
«La consola rechazó la autenticación SSH». Actualiza la contraseña en Ajustes → Conexión (Sustituir la
contraseña). Con una clave SSH, comprueba que su clave pública está en ~/.ssh/authorized_keys en la consola.
La clave de la consola ha cambiado¶
«La clave de la consola ha cambiado». El dispositivo que hay en esta dirección presenta una clave distinta de la
que aprobaste. Es normal tras reinstalar el firmware o cambiar la tarjeta; si no, puede tratarse de otro
dispositivo. Vuelve a comprobar la huella con ssh-keyscan (consulta
Conexión) antes de aprobar la nueva clave.
«No se encuentra la carpeta de ROMs» o «La carpeta de ROMs está vacía»¶
Comprueba que la tarjeta está en su sitio y, después, la ruta en Ajustes → Conexión. Ajustes → Sistema propone la carpeta encontrada en la consola. Si la carpeta está vacía mientras el catálogo tiene juegos, la sincronización se rechaza y no cambia nada.
Juegos¶
«No se puede lanzar a distancia»¶
En Anbernic, lanzar a distancia requiere el Stock OS Mod. En otros firmwares, comprueba lo que permite el perfil en Ajustes → Sistema y en Consolas compatibles.
Los botones de la consola ya no controlan el juego¶
El jugador 1 sigue asignado a un mando que no está conectado. Abre Mandos y pulsa Usar los botones de la consola.
No hay carátulas¶
«Banco de carátulas inaccesible»: el ordenador no tiene acceso a Internet. Las carátulas ya descargadas siguen disponibles. Algunos juegos no tienen carátula en la colección de libretro: cambia Imágenes a Imágenes de la tarjeta en la biblioteca.
«Espacio insuficiente en la tarjeta»¶
La copia necesita el tamaño de los archivos más un margen de 256 MB. Quita archivos de la lista o libera espacio en la tarjeta.
Partidas¶
«Hay un juego en marcha en la consola»¶
Restaurar o eliminar una partida se rechaza durante un juego, porque el juego reescribiría el archivo al salir. Sal primero del juego.
Bluetooth¶
Un mando no se empareja¶
Los mandos recientes (Xbox, 8BitDo…) solo se emparejan durante una búsqueda activa. Pon el mando en modo emparejamiento, pulsa Buscar dispositivos y luego Emparejar y conectar. Si está emparejado pero no responde, despiértalo (botón Xbox o Home) y pulsa Conectar.
Los dispositivos desaparecen tras un reinicio¶
El firmware de Anbernic borra los emparejamientos Bluetooth en cada arranque. Vuelve a emparejarlos desde la página Bluetooth.
No hay sonido en el altavoz Bluetooth¶
Pulsa Enviar el sonido de los juegos aquí junto al altavoz y luego lanza el juego desde ROMKADE Manager: los juegos lanzados desde el propio menú de la consola siguen usando sus altavoces.
Búsqueda¶
La búsqueda no tolera errores tipográficos¶
Typesense no está en marcha, así que se usa la búsqueda integrada. Inicia Docker Desktop y luego reinicia ROMKADE Manager.
¿Sigues atascado?¶
Consulta Acerca de para informar del problema. Incluye el mensaje mostrado, el modelo de la consola y su firmware.