docs: plan RomM migration

This commit was merged in pull request #197.
This commit is contained in:
2026-10-19 20:04:50 -04:00
parent 591144df33
commit f1a93199c7
5 changed files with 220 additions and 0 deletions

View File

@@ -0,0 +1,17 @@
---
aliases:
- "0013"
- OIDC Provider
date-created: 2026-10-19 19:40
date-modified: 2026-10-19 19:40
status: open
area: "[[homelab]]"
blocked-by: []
subtasks: []
---
# OIDC Provider
Deploy an OpenID Connect provider for homelab services.
Configure a RomM client after the provider is available.

View File

@@ -0,0 +1,42 @@
---
aliases:
- "0014"
- RomM Guest
date-created: 2026-10-19 19:40
date-modified: 2026-10-19 19:40
status: open
area: "[[homelab]]"
blocked-by: []
subtasks: []
---
# RomM Guest
Deploy a dedicated RomM guest on Pikachu with Nixpkgs RomM 5.2.0.
Follow the standard guest-provisioning protocol.
Keep the old installation's public domain.
Use the local PostgreSQL and Redis instances from `services.romm`.
Set guest limits to `4G` memory, `200%` CPU, and `512` tasks.
Enable the library watcher.
Use RomM built-in accounts.
Mount persistent application data:
```text
/pikachu/data/romm -> /var/lib/romm
/pikachu/data/romm/postgresql -> /var/lib/postgresql
/pikachu/data/romm/redis -> /var/lib/redis-romm
```
Mount browsable media:
```text
/pikachu/media/games/emulation/roms -> /var/lib/romm/library/roms
/pikachu/media/games/emulation/bios -> /var/lib/romm/library/bios
/pikachu/media/games/emulation/users -> /var/lib/romm/assets/users
```
Configure IGDB, ScreenScraper, and SteamGridDB from secrets.
Use RomM's default metadata, artwork, region, and language priorities.

View File

@@ -0,0 +1,31 @@
---
aliases:
- "0015"
- RomM 5.4 Package
date-created: 2026-10-19 19:40
date-modified: 2026-10-19 19:40
status: open
area: "[[homelab]]"
blocked-by:
- "[[0014-romm-guest]]"
subtasks: []
---
# RomM 5.4 Package
Package RomM 5.4.0 locally.
Reuse `services.romm`.
Manage `config.yml` declaratively with Nix.
Declare the Structure A library layout:
```yaml
filesystem:
structure:
default: "roms/{platform}/{game}"
firmware: "bios/{platform}"
```
Keep library conversion disabled.
Disable automatic browser save synchronization until browser emulation is needed.
Keep the IGDB, ScreenScraper, and SteamGridDB configuration unchanged.

View File

@@ -0,0 +1,24 @@
---
aliases:
- "0016"
- RomM Manual ROM Migration
date-created: 2026-10-19 19:40
date-modified: 2026-10-19 19:40
status: open
area: "[[homelab]]"
blocked-by:
- "[[0014-romm-guest]]"
subtasks: []
---
# RomM Manual ROM Migration
Manually copy selected ROMs and BIOS files from the old installation.
Copy ROMs to `/pikachu/media/games/emulation/roms`.
Copy BIOS files to `/pikachu/media/games/emulation/bios`.
Do not migrate the old database, users, sessions, job queue, or other application state.
Do not add automatic import tooling or a ROM manifest.
This task does not change monorepo configuration.