selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

RomM logo

Self-host RomM

5.4.1

Self-hosted ROM manager with in-browser play and save sync

ReleaseOpen SourceAGPL-3.0
Updated3 weeks ago
LanguagePython
Setup difficultyModerate
Stars
14 389
CPU
any modest CPU
RAM
512 MB RAM (minimum), 2 GB RAM (comfortable)
Port
8080 (HTTP web server)
Docker
rommapp/romm
Install with Docker Compose
RomM collection browser showing game library with cover art

What is RomM?

RomM (ROM Manager) is a self-hosted web application for organizing and playing retro game collections. It scans ROM folders, pulls metadata from providers like IGDB, ScreenScraper, LaunchBox, MobyGames, SteamGridDB and RetroAchievements, and supports over 400 platforms. Games can be played directly in the browser using EmulatorJS (for consoles up to ~N64/PS1) and Ruffle (for Flash). Save states and SRAM are synced across devices, with official companion apps for Playnite (Windows), Argosy (Android handhelds) and Grout (custom firmware handhelds). User management includes granular permissions and OIDC single sign-on (Authelia, Authentik, Keycloak, etc.). The stack runs via Docker Compose with MariaDB and Valkey/Redis, and there are platform-specific guides for Unraid, Synology, TrueNAS SCALE, Kubernetes and more. Licensed AGPL-3.0 with no paid tiers or tracking.

RomM alternatives

Should you self-host RomM?

RomM scores 79/100 on selfhost.directory (how scoring works) and ranks #1 of 5 in Emulation. It has 14 389 GitHub stars, +834 in the last 30 days.

It shipped 10 stable releases in the past year. The latest, 5.4.1, came out on 22 October 2026. New versions land roughly every 2 weeks.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is AGPL-3.0-licensed and written mostly in Python.

Its closest alternative on selfhost.directory is daedalOS (71/100, 13 099 stars). RomM scores higher overall. See RomM vs daedalOS side by side.

Features

  • 400+ platform support
  • Emulator streaming
  • In-browser emulation
  • Kiosk Mode
  • Metadata Enrichment
  • Multi-user with permissions
  • Netplay
  • OIDC Single Sign-On
  • Physical games support
  • REST API
  • ROM conversion
  • ROM patcher
  • Save state sync

RomM README

romm logo
A beautiful, powerful, self-hosted ROM manager and player.
Trendshift hackernews badge
selfh.st badge Discord

Overview

Scan, enrich, browse and play your ROM collection from one beautiful & free self-hosted app. Metadata from 10+ providers, save sync across your devices, and support for over 400 platforms. RomM is a must-have for anyone who plays on emulators.

Browsing a library and playing a game in RomM

How to install RomM

Install RomM with Docker Compose

Docker and Docker Compose
Environment variables
ROMM_AUTH_SECRET_KEY, DB_HOST, DB_NAME, DB_USER, DB_PASSWD, SCREENSCRAPER_USER, SCREENSCRAPER_PASSWORD, RETROACHIEVEMENTS_API_KEY, STEAMGRIDDB_API_KEY, HASHEOUS_API_ENABLED

version: "3" volumes: mysql_data: romm_resources: romm_redis_data: services: romm: image: rommapp/romm:latest container_name: romm restart: unless-stopped environment: - DB_HOST=romm-db - DB_NAME=romm - DB_USER=romm-user - DB_PASSWD= - ROMM_AUTH_SECRET_KEY= - SCREENSCRAPER_USER= - SCREENSCRAPER_PASSWORD= - RETROACHIEVEMENTS_API_KEY= - STEAMGRIDDB_API_KEY= - HASHEOUS_API_ENABLED=true volumes: - romm_resources:/romm/resources - romm_redis_data:/redis-data - /path/to/library:/romm/library - /path/to/assets:/romm/assets - /path/to/config:/romm/config ports: - 80:8080 depends_on: romm-db: condition: service_healthy restart: true romm-db: image: mariadb:latest container_name: romm-db restart: unless-stopped environment: - MARIADB_ROOT_PASSWORD= - MARIADB_DATABASE=romm - MARIADB_USER=romm-user - MARIADB_PASSWORD= volumes: - mysql_data:/var/lib/mysql healthcheck: test: [CMD, healthcheck.sh, --connect, --innodb_initialized] start_period: 30s start_interval: 10s interval: 10s timeout: 5s retries: 5

Requires Docker and Docker Compose. Edit paths and secrets before starting.

RomM releases & version history

@ Every self-hosted release, weekly

One Monday email with the week's stable releases across the directory.

FAQ

Who runs RomM?

A small team of maintainers plus active community contributors. Support via Open Collective.

Can I use RomM without the internet?

Internet is needed for initial metadata scans, Docker image pulls, and OIDC login. After setup, browsing and playing can work offline.

How do I back up?

mysqldump the database and rsync the /romm/assets and /romm/config volumes nightly. Full procedure in Backup & Restore docs.

Can guests browse without an account?

Yes, set KIOSK_MODE=true in environment variables for anonymous read-only access.

Can I share my library with friends?

Yes, add them as users via the invite flow. Expose publicly behind a reverse proxy with TLS, or keep private and share over VPN/Tailscale.

Can I play PS3 or newer consoles in the browser?

No. In-browser emulation handles 4th-gen and earlier systems well. Saturn, PS1, and N64 are hit-or-miss. PSP and newer are mostly unplayable.

How do I update?

Run 'docker compose pull rommapp/romm' then 'docker compose up -d romm'. Read release notes before minor or major upgrades.

How much RAM/CPU does it need?

Minimum: 512 MB RAM, any modest CPU. Comfortable: 2 GB RAM, 2 cores. Heaviest CPU usage is during scans.

Is RomM legal?

The software itself is legal, but the legality of ROMs depends on your jurisdiction. RomM does not ship ROMs or firmware.

Do I need metadata API keys?

RomM runs without API keys, but games won't match against metadata sources, so you won't get covers, descriptions, or ratings.

Is it free?

Yes, RomM is licensed under AGPL-3.0 and is completely free with no tracking, no paid features, and no upsells.

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…