Administration

Administration is everything you do as the operator of a RomM instance: managing accounts, controlling access, configuring metadata sources, scheduling scans, watching the library for changes, monitoring the server, and keeping data safe.

The end-user equivalent (how to actually play the games, build collections, upload saves) lives in Using RomM.

Where things live

Users & access

• Users & Roles: roles, the scope model, how permissions add up
• Invitations & Registration: invite links, public signup, first-user setup
• Authentication: session config, password reset, Client API Tokens for devices
• OIDC Setup: Authelia, Authentik, Keycloak, PocketID, Zitadel, VoidAuth, SSO + role mapping

Content & library

• Metadata Providers: all providers, credentials, priority ordering
• Scanning & Watcher: how scans work, scan modes, filesystem watcher
• Firmware Management: BIOS/firmware uploads for emulation

Operations

• Scheduled Tasks: what runs in the background and how to tune it
• Server Stats: the stats page and what its numbers mean
• Observability: logs, Sentry, OpenTelemetry, /heartbeat

Configuration

• Environment Variables: every env var, grouped by area
• Configuration File: the config.yml schema

Keeping data safe

• Backup & Restore: routine backups, restore drill, host migration