fix: restore MariaDB definers after backup recovery

Recreate and reset the accounts required by restored RomM views, triggers, and loopback database access before MariaDB accepts network connections.

Release the restore fix as 5.1.0:10.

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,32 @@
+#!/bin/sh
+set -eu
+
+/usr/local/bin/docker-entrypoint.sh "$@" --skip-networking &
+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'@'%' IDENTIFIED BY '$MARIADB_PASSWORD'; ALTER USER 'romm'@'%' IDENTIFIED BY '$MARIADB_PASSWORD'; GRANT ALL PRIVILEGES ON romm.* TO 'romm'@'%'; 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';"
+
+kill -TERM "$server_pid"
+wait "$server_pid"
+
+exec /usr/local/bin/docker-entrypoint.sh "$@"

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:10',
   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.',
+      'Restores the MariaDB account required by RomM view and trigger definers after backup recovery. 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.',
+      'Restaura la cuenta de MariaDB requerida por los definidores de vistas y disparadores de RomM después de recuperar una copia de seguridad. 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.',
+      'Stellt nach einer Sicherungswiederherstellung das MariaDB-Konto wieder her, das von den Definern der RomM-Views und Trigger benötigt wird. 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.',
+      'Przywraca po odzyskaniu kopii zapasowej konto MariaDB wymagane przez definicje widoków i wyzwalaczy RomM. 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.',
+      'Restaure après récupération d’une sauvegarde le compte MariaDB requis par les définisseurs des vues et déclencheurs RomM. Notes complètes : https://github.com/rommapp/romm/releases/tag/5.1.0',
   },
   migrations: {
     up: async () => {},