fix(romm): 🐛 align RomM mounts with local RetroPie base

Author: alsd4git

romm/.env.example

@@ -0,0 +1,18 @@
+# RomM Stack Environment Variables
+
+# Required
+DOCKER_DATA_BASEFOLDER=/opt/docker/data
+DOCKER_MEDIA_BASEFOLDER=/opt/docker/media
+LOCAL_RETROPIE_BASE=/opt/docker/media/retropie
+ROMM_DB_NAME=romm
+ROMM_DB_USER=romm-user
+ROMM_DB_PASSWORD=REPLACE_ME
+ROMM_DB_ROOT_PASSWORD=REPLACE_ME
+ROMM_AUTH_SECRET_KEY=REPLACE_ME
+
+# Optional metadata providers
+SCREENSCRAPER_USER=
+SCREENSCRAPER_PASSWORD=
+RETROACHIEVEMENTS_API_KEY=
+STEAMGRIDDB_API_KEY=
+HASHEOUS_API_ENABLED=true

romm/README.md

@@ -0,0 +1,16 @@
+# RomM Stack
+
+RomM game library manager with MariaDB backend, adapted for a reverse-proxied homelab setup.
+
+## Configuration
+
+1. Copy `.env.example` to `.env`.
+2. Set the database credentials and `ROMM_AUTH_SECRET_KEY`.
+3. Set `LOCAL_RETROPIE_BASE` to the root folder that contains `roms/` and `BIOS/`.
+
+## Notes
+
+- The RomM web container is exposed internally on `8080` and joins `npm_network`.
+- MariaDB stays on the internal `romm_network`.
+- The ROM library and BIOS are mounted from `LOCAL_RETROPIE_BASE`.
+- Runtime secrets live in `.env`, not in the compose file.

romm/compose.yaml

@@ -24,7 +24,9 @@ services:
     volumes:
       - romm_resources:/romm/resources # Resources fetched from IGDB (covers, screenshots, etc.)
       - romm_redis_data:/redis-data # Cached data for background tasks
-      - ${DOCKER_MEDIA_BASEFOLDER:-/opt/docker/media}/roms:/romm/library # Your game library. Check https://docs.romm.app/latest/Getting-Started/Folder-Structure/ for more details.
+      # - ${DOCKER_MEDIA_BASEFOLDER:-/opt/docker/media}/romm_library:/romm/library # Your game library. Check https://docs.romm.app/latest/Getting-Started/Folder-Structure/ for more details.
+      - ${LOCAL_RETROPIE_BASE:-/opt/docker/media/retropie}/roms:/romm/library/roms
+      - ${LOCAL_RETROPIE_BASE:-/opt/docker/media/retropie}/BIOS:/romm/library/bios
       - ${DOCKER_DATA_BASEFOLDER:-/opt/docker/data}/romm/assets:/romm/assets # Uploaded saves, states, etc.
       - ${DOCKER_DATA_BASEFOLDER:-/opt/docker/data}/romm/config:/romm/config # (Optional) Path where config.yml is stored
     expose: