Skip to content

ROM Hub Plugins

BlizzHacker edited this page Nov 17, 2026 · 1 revision

ROM Hub Plugins

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).

Install a plugin

  1. Open Hub → Plugins.
  2. Choose a plugin and click Install.
  3. For searchable plugins, add a ROM Hub download client under Settings → Download Clients.

How plugins are confined

  • 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 pyseccomp is missing), plugins do not run until you fix it or explicitly set ROMARR_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.

Clone this wiki locally