Saltar a contenido

Instalación

ROMKADE Manager se instala con Docker, de la misma forma en macOS, Windows y Linux. Calcula unos diez minutos la primera vez, casi todos para instalar Docker.

1. Instala Docker

  1. Descarga Docker Desktop desde la documentación oficial de Docker, eligiendo tu procesador (Apple Silicon o Intel).
  2. Abre el archivo descargado y arrastra Docker a la carpeta Aplicaciones.
  3. Inicia Docker Desktop y espera a que indique que el motor está en marcha (icono de la ballena en la barra de menús).
  4. Si macOS pregunta si Docker puede buscar dispositivos en tu red local, permítelo: es lo que permite a ROMKADE Manager llegar a la consola.
  1. Activa WSL 2 siguiendo la guía de Microsoft.
  2. Instala Docker Desktop desde la documentación oficial de Docker, con la opción WSL 2.
  3. Reinicia si el instalador lo pide, luego inicia Docker Desktop y espera a que el motor esté en marcha.
  4. Si el Firewall de Windows lo pide, permite Docker en las redes privadas.
  1. Instala Docker Engine siguiendo la página de tu distribución en la documentación oficial.
  2. Instala el plugin Docker Compose (instrucciones).
  3. Opcional: sigue los pasos posteriores a la instalación para usar Docker sin sudo. Si no, pon sudo delante de los comandos docker de abajo.

Compruébalo en un terminal (Terminal en macOS y Linux, PowerShell en Windows): los dos comandos deben mostrar un número de versión.

docker --version
docker compose version

2. Descarga e inicia ROMKADE Manager

Estos comandos crean una carpeta romkade, descargan en ella el archivo oficial compose.yaml de la última versión y luego inician ROMKADE Manager en segundo plano.

mkdir romkade && cd romkade
curl -fsSLO https://github.com/RomKade/romkade-manager/releases/latest/download/compose.yaml
docker compose up -d

mkdir romkade; cd romkade
curl.exe -fsSLO https://github.com/RomKade/romkade-manager/releases/latest/download/compose.yaml
docker compose up -d

El primer arranque descarga las imágenes (unos cientos de MB). Puedes leer el archivo antes de iniciarlo: describe dos servicios, ROMKADE Manager y su motor de búsqueda, y nada más.

3. Abre la interfaz

Abre http://localhost:8765 en tu navegador. Un aviso muestra las condiciones de uso en el primer arranque; siguen disponibles en todo momento desde la barra lateral.

La interfaz solo responde en este ordenador: es a propósito, ya que controla tu consola.

Siguiente paso

Conecta tu consola.

Conviene saber

  • Nada que configurar: el archivo funciona tal cual.
  • Tus datos (catálogo, ajustes, copias de partidas, secretos) están en el volumen Docker romkade-data. Resisten las actualizaciones y docker compose down. Consulta Datos y privacidad.
  • Arranque automático: ROMKADE Manager vuelve a arrancar con Docker. Para detenerlo: docker compose down en la carpeta romkade.

  • ¿El puerto 8765 ya está en uso? Inicia con otro puerto y abre ese (por ejemplo http://localhost:8780):

    ROMKADE_PORT=8780 docker compose up -d

    $env:ROMKADE_PORT=8780; docker compose up -d

Actualizar

En la carpeta romkade:

docker compose pull
docker compose up -d

Las notas de versión están en GitHub. Tus datos se conservan.

Comandos útiles

Ejecútalos en la carpeta romkade.

Comando Efecto
docker compose ps Estado de los servicios
docker compose logs -f Registros en directo (Ctrl+C deja de seguirlos; el servicio sigue en marcha)
docker compose pull Descarga la nueva versión de las imágenes, sin reiniciar nada
docker compose up -d Inicia, o reinicia con las imágenes actualizadas
docker compose down Detiene y elimina los contenedores; los volúmenes, y por tanto tus datos, se conservan

Nunca docker compose down -v por costumbre

La opción -v también borra los volúmenes: se perderían el catálogo, las copias de partidas y los ajustes.

Desde el código fuente (macOS)

Para quienes contribuyen, o para usar la aplicación desde un móvil. Requiere Python 3.13 de python.org (el Python de Homebrew queda bloqueado por el permiso Red local de macOS y no puede llegar a la consola), y Node 20 o superior (brew install node) para compilar la interfaz.

git clone https://github.com/RomKade/romkade-manager.git
cd romkade-manager
./run.sh

En la primera ejecución, el script crea el entorno de Python y compila la interfaz (unos minutos), luego inicia el servidor y abre http://127.0.0.1:8765. Deja abierta la ventana del Terminal; Ctrl+C detiene el servidor. La primera vez, permite que el Terminal busque dispositivos en la red local.

  • Las contraseñas y las claves van al llavero de macOS; los datos, a ~/Library/Application Support/AnbernicGameManager/.
  • La búsqueda usa Typesense si Docker Desktop está en marcha (contenedor agm-typesense); si no, una búsqueda integrada.
  • Actualizar: git pull y después ./run.sh.