Primeros pasos
- Abre
http://<SERVER-IP>en tu navegador. - El primer arranque puede tardar un rato.
- En la primera visita, RomM te redirige al asistente de configuración.
- Completa el asistente de configuración.
- Crea el nombre de usuario y la contraseña del administrador.
- La primera cuenta creada se convierte en administrador.
Biblioteca de ROM
- Coloca tus archivos ROM en:
/root/romm/library/roms - Coloca los archivos de BIOS en:
/root/romm/library/bios - Después de añadir juegos, ejecuta un escaneo de la biblioteca desde la interfaz web de RomM.
Metadatos
- Hasheous metadata support lets RomM retrieve game metadata without requiring an API key.
- Se pueden configurar más proveedores de metadatos en:
/root/romm/.env
Archivos y directorios importantes
- Ruta de instalación:
/root/romm - Archivo Compose:
/root/romm/docker-compose.yml - Archivo de entorno:
/root/romm/.env - Biblioteca de ROM:
/root/romm/library - ROM:
/root/romm/library/roms - BIOS:
/root/romm/library/bios - Recursos:
/root/romm/assets - Configuración:
/root/romm/config - Configuración de Caddy:
/etc/caddy/Caddyfile - Datos de MariaDB:
/var/lib/docker/volumes/romm_mysql_data
Gestión de Docker
Ver el estado:
docker ps
Ver registros:
cd /root/romm
docker compose logs -f
Reiniciar los servicios:
cd /root/romm
docker compose restart
Detener los servicios:
cd /root/romm
docker compose down
Iniciar los servicios:
cd /root/romm
docker compose up -d
Dominio y HTTPS (Caddy)
Nota: los certificados TLS de Let's Encrypt no pueden emitirse para direcciones IP. Hace falta un nombre de dominio.
1. Apunta un dominio (por ejemplo example.com) a la dirección IP de tu servidor.
2. Edita /root/romm/.env y actualiza ROMM_BASE_URL:
BASE_URL=https://example.com
3. Vuelve a crear los servicios:
docker compose -f /root/romm/docker-compose.yml up -d
4. Update the site address in /etc/caddy/Caddyfile desde http://<SERVER_IP> por tu dominio. Deja sin cambios la compresión, las cabeceras y la configuración del proxy inverso.
vim /etc/caddy/Caddyfile
Cambia:
http://<SERVER_IP> {
para:
example.com {
5. Recarga Caddy:
systemctl reload caddy
6. Caddy obtendrá y renovará automáticamente un certificado de Let's Encrypt.
7. Accede a RomM en: https://example.com