Fixes backup restore by recreating and resetting the MariaDB account RomM uses over the internal loopback connection, including backups that restore the database root credential.

README.md

@@ -4,6 +4,12 @@ This repository packages [RomM](https://github.com/rommapp/romm) 5.1.0 as a nati
 
 RomM scans, enriches, browses, and manages a personal game library from a web interface. This package uses the official RomM container and a private MariaDB sidecar. RomM's bundled Redis instance, web server, migrations, watcher, worker, and scheduler are started by the upstream `/init` process.
 
+## Quick start (StartOS)
+
+Install RomM from the start9.tabordalab.com (TabordaLab StartOS registry), or sideload the `.s9pk` package.
+
+<img width="1419" height="527" alt="image" src="https://github.com/user-attachments/assets/38d7f4f6-73e2-4b8d-a855-b00aa41f852f" />
+
 ## Architecture
 
 - `rommapp/romm:5.1.0` serves the UI on internal port `8080`.

docker-images/mariadb/Dockerfile

@@ -1,10 +1,13 @@
 FROM mariadb:11.4.5@sha256:49117dcc565cf51aa57ac5fca59ab31213402ff0eae6ffc13c46a37b938f7e4b
 
-# start-sdk 2.0.9's logical backup helper invokes the legacy MySQL command
-# names. MariaDB 11.4 ships only mariadb-* names, so expose compatibility
-# aliases until these commands are configurable by the SDK.
 RUN ln -s /usr/bin/mariadb-admin /usr/local/bin/mysqladmin \
     && ln -s /usr/bin/mariadb-dump /usr/local/bin/mysqldump \
     && ln -s /usr/bin/mariadb /usr/local/bin/mysql \
     && ln -s /usr/bin/mariadb-install-db /usr/local/bin/mysql_install_db \
     && ln -s /usr/sbin/mariadbd /usr/local/bin/mysqld
+
+COPY startos-entrypoint.sh /usr/local/bin/startos-entrypoint.sh
+
+ENTRYPOINT ["/usr/local/bin/startos-entrypoint.sh"]
+
+CMD ["mariadbd"]

docker-images/mariadb/startos-entrypoint.sh

@@ -0,0 +1,29 @@
+#!/bin/sh
+set -eu
+
+/usr/local/bin/docker-entrypoint.sh "$@" &
+server_pid=$!
+
+trap 'kill -TERM "$server_pid" 2>/dev/null || true; wait "$server_pid"' TERM INT
+
+root_password=''
+
+until {
+  if mariadb --protocol=socket --user=root --password="$MARIADB_ROOT_PASSWORD" --execute 'SELECT 1' >/dev/null 2>&1; then
+    root_password="$MARIADB_ROOT_PASSWORD"
+  elif mariadb --protocol=socket --user=root --password="$MARIADB_PASSWORD" --execute 'SELECT 1' >/dev/null 2>&1; then
+    root_password="$MARIADB_PASSWORD"
+  else
+    false
+  fi
+}; do
+  if ! kill -0 "$server_pid" 2>/dev/null; then
+    wait "$server_pid"
+    exit $?
+  fi
+  sleep 1
+done
+
+mariadb --protocol=socket --user=root --password="$root_password" --execute "CREATE USER IF NOT EXISTS 'romm'@'127.0.0.1' IDENTIFIED BY '$MARIADB_PASSWORD'; ALTER USER 'romm'@'127.0.0.1' IDENTIFIED BY '$MARIADB_PASSWORD'; GRANT ALL PRIVILEGES ON romm.* TO 'romm'@'127.0.0.1'; FLUSH PRIVILEGES;"
+
+wait "$server_pid"

startos/manifest/index.ts

@@ -5,7 +5,7 @@ export const manifest = setupManifest({
   id: 'romm',
   title: 'RomM',
   license: 'AGPL-3.0',
-  packageRepo: 'https://github.com/alex/romm-startos',
+  packageRepo: 'https://github.com/alextab93/romm-startos',
   upstreamRepo: 'https://github.com/rommapp/romm',
   marketingUrl: 'https://romm.app/',
   donationUrl: null,

startos/versions/current.ts

@@ -1,18 +1,18 @@
 import { IMPOSSIBLE, VersionInfo } from '@start9labs/start-sdk'
 
 export const current = VersionInfo.of({
-  version: '5.1.0:0',
+  version: '5.1.0:4',
   releaseNotes: {
     en_US:
-      'Updates RomM to 5.1.0 with the redesigned UI, security fixes, enhanced library scanning, and native support for cross-directory hardlinks.',
+      'Fixes backup restore by recreating and resetting the MariaDB account RomM uses over the internal loopback connection, including backups that restore the database root credential. Full release notes: https://github.com/rommapp/romm/releases/tag/5.1.0',
     es_ES:
-      'Actualiza RomM a 5.1.0 con la interfaz rediseñada, correcciones de seguridad, escaneo mejorado y soporte nativo para enlaces físicos entre directorios.',
+      'Corrige la restauración de copias de seguridad al recrear y restablecer la cuenta de MariaDB que RomM usa mediante la conexión interna de bucle local, incluso cuando la copia restaura la credencial raíz de la base de datos. Notas completas: https://github.com/rommapp/romm/releases/tag/5.1.0',
     de_DE:
-      'Aktualisiert RomM auf 5.1.0 mit neuer Oberfläche, Sicherheitskorrekturen, verbessertem Bibliotheksscan und nativer Unterstützung für verzeichnisübergreifende Hardlinks.',
+      'Behebt die Wiederherstellung von Backups, indem das MariaDB-Konto für RomMs interne Loopback-Verbindung erneut erstellt und zurückgesetzt wird, auch wenn das Backup das Root-Zugangspasswort der Datenbank wiederherstellt. Vollständige Versionshinweise: https://github.com/rommapp/romm/releases/tag/5.1.0',
     pl_PL:
-      'Aktualizuje RomM do 5.1.0 z przeprojektowanym interfejsem, poprawkami bezpieczeństwa, ulepszonym skanowaniem i obsługą dowiązań twardych między katalogami.',
+      'Naprawia przywracanie kopii zapasowych, odtwarzając i resetując konto MariaDB używane przez RomM przez wewnętrzne połączenie loopback, także gdy kopia przywraca poświadczenie roota bazy danych. Pełne informacje o wydaniu: https://github.com/rommapp/romm/releases/tag/5.1.0',
     fr_FR:
-      'Met RomM à jour vers 5.1.0 avec une interface repensée, des correctifs de sécurité, une analyse améliorée et la prise en charge des liens physiques entre répertoires.',
+      'Corrige la restauration des sauvegardes en recréant et en réinitialisant le compte MariaDB que RomM utilise par la connexion interne de bouclage, y compris si la sauvegarde restaure le mot de passe root de la base de données. Notes complètes : https://github.com/rommapp/romm/releases/tag/5.1.0',
   },
   migrations: {
     up: async () => {},