docs: plan RomM migration
This commit was merged in pull request #197.
This commit is contained in:
17
docs/03 wrk/tasks/0013-oidc-provider.md
Normal file
17
docs/03 wrk/tasks/0013-oidc-provider.md
Normal 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.
|
||||
42
docs/03 wrk/tasks/0014-romm-guest.md
Normal file
42
docs/03 wrk/tasks/0014-romm-guest.md
Normal 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.
|
||||
31
docs/03 wrk/tasks/0015-romm-5-4-package.md
Normal file
31
docs/03 wrk/tasks/0015-romm-5-4-package.md
Normal 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.
|
||||
24
docs/03 wrk/tasks/0016-romm-manual-rom-migration.md
Normal file
24
docs/03 wrk/tasks/0016-romm-manual-rom-migration.md
Normal 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.
|
||||
Reference in New Issue
Block a user