Repository navigation
ROM Hub Plugins
BlizzHacker edited this page Nov 17, 2026
·
1 revision
ROM Hub is ROMarr's plugin host. Each plugin adds a source or capability. ROM Hub ships in the amd64 and arm64 Docker images (not armv7).
- Open Hub → Plugins.
- Choose a plugin and click Install.
- For searchable plugins, add a ROM Hub download client under Settings → Download Clients.
- On Linux, plugins run under a seccomp filter (
pyseccomp) that blocks network and process creation they don't need. Seccomp isn't available on Windows. - On Linux, if confinement isn't available (for example
pyseccompis missing), plugins do not run until you fix it or explicitly setROMARR_ALLOW_UNSANDBOXED_PLUGINS=1. The status page says why. - Windows and macOS have no seccomp, so the desktop apps run plugins without confinement and say so. Install only plugins you trust there.
- Backend usernames and passwords (for example your RomM login) are not passed to plugins unless you opt in.
- ROMarr starts the plugin worker before any plugin code can run its own start-up hooks.
The rest of ROMarr keeps working when plugins are refused.
Source plugins are developed in ROM Hub.
Full guide: PLUGINS.md. Security policy: SECURITY.md.
ROMarr is MIT licensed · Report a problem · Detailed, release-tracked docs live in the repository's docs folder.