Skip to content

docs: cover RomM 5.0.0-beta.1 config, auth, and admin changes#93

Merged
gantoine merged 7 commits into
mainfrom
posthog-code/romm-5.0-docs
Jul 10, 2026
Merged

docs: cover RomM 5.0.0-beta.1 config, auth, and admin changes#93
gantoine merged 7 commits into
mainfrom
posthog-code/romm-5.0-docs

Conversation

@gantoine

Copy link
Copy Markdown
Member

What

Updates the configuration / setup / env-var / admin surface of the docs to match RomM 5.0.0-beta.1. Verified against source at the beta tag (env template, Role enum, permission.py, Scope enum).

Changes

  • Env vars — regenerated env-vars.md snippet; adds DISABLE_LOGS_VIEWER and OIDC_ALLOW_REGISTRATION (only diff is those two vars).
  • Users & Roles — full rewrite: roles collapse to User / Admin (Admin bypasses groups); documents the new permission-group model (grant matrix over 9 entities × read/write/delete, own_only, default group, per-user overrides, hidden platforms/ROMs). Replaced the old role-column scope matrix with an OAuth scopes reference (20 dotted scopes incl. the new logs.read).
  • Auth / OIDC / registration — documented OIDC_ALLOW_REGISTRATION, reframed role mapping around User/Admin, flagged OIDC_ROLE_VIEWER/OIDC_ROLE_EDITOR as legacy no-ops (touches authentication.md, invitations-and-registration.md, oidc/index.md, oidc/keycloak.md, oidc/zitadel.md).
  • Observability — added the in-app logs viewer gated by DISABLE_LOGS_VIEWER (also disables GET /api/logs).
  • Smaller itemsbox2d_side media type in the config reference; Turkish (tr_TR) locale; glossary rewrite; swept stale Viewer/Editor references out of the developer API docs, uploads, collections, ROM patcher (+ light server-side-patching note), netplay, account/profile, and Playnite pages.

Notes

  • The permission-group UI is referenced as Administration → Permissions (inferred from the API router) — worth confirming against the actual beta UI.
  • env.template still ships OIDC_ROLE_VIEWER/EDITOR, so the autogenerated table still lists them; their legacy behavior is covered in prose instead.

Verification

mkdocs build passes with no link/anchor warnings (validated with the social-cards plugin disabled to sidestep a local cairosvg native-lib issue). No pages moved, so redirects are unaffected.


Created with PostHog Code

gantoine added 7 commits July 10, 2026 13:35
Update the config/setup/env/admin surface for the 5.0 beta:

- Regenerate env-vars reference (adds DISABLE_LOGS_VIEWER and
  OIDC_ALLOW_REGISTRATION)
- Rewrite Users & Roles around User/Admin + the new permission-group
  model (grant matrix, per-user overrides, hidden entities) and add an
  OAuth scopes reference (incl. new logs.read)
- Document OIDC_ALLOW_REGISTRATION and reframe OIDC role mapping around
  User/Admin; flag OIDC_ROLE_VIEWER/EDITOR as legacy no-ops
- Add the in-app logs viewer (DISABLE_LOGS_VIEWER) to Observability
- Smaller items: box2d_side media type, Turkish locale, glossary
  rewrite, and sweep stale Viewer/Editor references out of the API,
  uploads, collections, ROM patcher, netplay, and profile pages

Generated-By: PostHog Code
Task-Id: 13e38ba8-2f24-44e4-bf28-90f68145bfa6
5.0 moves patching from the browser to the server (patcherjs). Rewrite
the page around the Patcher tab flow: pick a base ROM + patch from the
library, apply server-side, then download and/or upload back (with an
automatic scan). Update permissions to roms.read (apply) / roms.write
(upload), document the ROM_PATCHER_MAX_FILE_SIZE_BYTES limit and the
checksum-validation warning, and drop the browser-memory framing.

Generated-By: PostHog Code
Task-Id: 13e38ba8-2f24-44e4-bf28-90f68145bfa6
Add miximage_v2, logo, and video_normalized to the scan.media table
to match the MetadataMediaType enum in 5.0.

Generated-By: PostHog Code
Task-Id: 13e38ba8-2f24-44e4-bf28-90f68145bfa6
d7bf201 was formatted with bare prettier (2-space), which diverges from
the repo's trunk-enforced prettier config (4-space). Reformat with trunk
so it matches CI; also adds the box2d_back media row that the reindent
had obscured. No content change beyond the scan.media additions.

Generated-By: PostHog Code
Task-Id: 13e38ba8-2f24-44e4-bf28-90f68145bfa6
@gantoine gantoine merged commit d2a2a7d into main Jul 10, 2026
4 checks passed
@gantoine gantoine deleted the posthog-code/romm-5.0-docs branch July 10, 2026 19:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant