ROMarr
ROMarr is a self-hosted application that automates game ROM acquisition for your library.
Platform availability
Available on 2 of 10 platforms
- Unraid
- TrueNAS
- Umbrel (not listed)
- ZimaOS (not listed)
- Proxmox (not listed)
- Helm (not listed)
- Mac (not listed)
- Windows (not listed)
- Linux (not listed)
- Any server (not listed)
Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
77/100 Good
- Maintained
- 100last commit 1 day ago
- Popular
- 52406 GitHub stars
- Easy to install
- 452 install platforms, install notes, Docker image
- Light to run
- No data
- Security check
- 95no serious findings, CI, tests
Based on 4 of 5 factors.
Availability: platform listings confirmed today
- GitHub stars
- 406
- Open issues
- 1
- Last commit
- 2026-11-20
- Latest release
- v1.11.5
- License
- MIT
- Activity
- rising
Checked yesterday - source: GitHub (BlizzHacker/romarr)
Resources & Compatibility
Requirements not published yet.
Checked 49 days ago - source: Docker Hub image tags and published docs
First-install notes
- First-Start Environment Variables ROMarr reads its environment variables only once, on first start, and copies them into its internal settings. After that, the saved settings take precedence and editing the container variables has no effect. This is intentional so you can adjust settings on the Settings page without touching the compose file or template. source
- Standalone operation ROMarr runs on its own and requires no parent application; optional extended source support is available via ROM Hub. source
- Standalone operation and plugins ROMarr works standalone; optional source plugins are added via ROM Hub and imported through ROMarr’s Hub tab. source
- Unraid Install Use the official Unraid app listing, which installs the ghcr.io/blizzhacker/romarr container image. source
- Start with one system and one game The README onboarding guide recommends starting with one gaming system and one game before adding ROMs or search sources. source
Fetched yesterday - each note links to its source
Variants
Alternatives
No alternatives collected yet.
Common questions
Do I need Prowlarr to use ROMarr with torrents?
ROMarr can search indexers through Prowlarr or directly. The chosen release is then passed to the matching download client or watched folder.
Which download clients can ROMarr use for torrents and usenet?
For torrents, it supports 13 daemons, 8 debrid services, or a watched folder. For usenet, it supports SABnzbd, NZBGet, NZBVortex, or a watched folder.
Can ROMarr file ROMs for front-ends that use a plain folder structure?
Yes, a folder mode writes a plain platform-organised directory tree. It is aimed at front-ends such as EmulationStation, Batocera, RetroPie, ES-DE, EmuDeck, Pegasus, Lakka, muOS, and LaunchBox.
If I change environment variables in my compose file after first start, will ROMarr pick them up?
No, ROMarr reads environment variables only once on first start and copies them into its internal settings. Saved settings take precedence, so you should adjust settings on the Settings page instead.
How do I add a new ROM source to ROMarr?
ROM Hub is where sources are written, run, and sandboxed as plugins. ROMarr picks them up from its Hub tab, so adding a source means writing a plugin there rather than patching ROMarr.
Answers sourced from github.com, github.com
Community
- Host Homarr in Home Assistant : r/selfhosted - Reddit (reddit)
- My Homarr setup : r/selfhosted - Reddit (reddit)
Collected 48 days ago - public community threads