Analytics cookies only (Google Analytics, PostHog). No ad networks, no cross-site tracking. See our privacy policy.
A game library server for DRM-free games and emulation. It scans folders on the server for platforms and games, downloads metadata and artwork from IGDB (you supply the credentials) and presents the library in a web client and in desktop clients for Windows, macOS and Linux. The desktop clients install and launch games through emulator profiles stored on the server, and the web client can download games and run some in the browser with EmulatorJS. It stores the library in PostgreSQL, either embedded in the image or an external server. There is no user login.
Runs on a VPS from $6/mo (Kamatera 2GB, 2 GB RAM) · prices checked Nov 2026
Fits home hardware (144 MB measured idle, RAM only): Raspberry Pi 4 (4 GB) (arm64 untested), Raspberry Pi 5 (8 GB) (arm64 untested), Repurposed laptop (8 GB), Intel N100 mini PC (16 GB), AMD Ryzen mini PC (32 GB).
Pick Retrom when you want a self-hosted game library that doubles as an emulator launcher: the server scans your game folders, pulls metadata and artwork from IGDB, and desktop clients for Windows, macOS and Linux install and launch games through per-client emulator profiles kept on the server, with a web client for browsing, downloading and some in-browser emulation. It is GPL-3.0, Rust and TypeScript, and stores its library in PostgreSQL. Our snippet follows the wiki's Docker example, pins `ghcr.io/jmberesford/retrom-service:v0.8.4` (released 2026-06-14, amd64 and arm64) instead of `latest`, and points it at a separate PostgreSQL 17 container through `dbUrl` in `config.json` (without that setting the image runs its own embedded PostgreSQL). We did not find an upstream RAM minimum, so our 512 MB floor is an estimate. Among the catalog's game libraries, Gameyfin focuses on browsing and downloading DRM-free games from a web page, RomM and Gaseous on ROMs and playing in the browser, and GameVault has desktop clients that browse, download, install and launch games, with user accounts; Retrom's difference is per-client emulator profiles stored on the server, for launching emulated games, at the price of having no user accounts.
Paid link — we earn a commission if you shop through it.
Run these commands on your server:
# Retrom — game library server — adapted from the wiki's Docker example, pinned to v0.8.4, with an external PostgreSQL 17 set through dbUrl in config.json (without it the image starts its own embedded PostgreSQL)
mkdir -p library config
echo "PGPASSWORD=$(openssl rand -hex 16)" > .env
cat > config/config.json <<EOF
{
"connection": { "port": 5101, "dbUrl": "postgres://retrom:$(sed -n 's/^PGPASSWORD=//p' .env)@retrom-db:5432/retrom" },
"contentDirectories": [ { "path": "/app/library", "storageType": "MultiFileGame" } ]
}
EOF
cat > docker-compose.yml <<'EOF'
services:
retrom-db:
image: postgres:17-alpine
restart: unless-stopped
environment:
POSTGRES_USER: retrom
POSTGRES_PASSWORD: ${PGPASSWORD}
POSTGRES_DB: retrom
healthcheck:
test: ["CMD-SHELL", "pg_isready -U retrom -d retrom"]
interval: 5s
timeout: 5s
retries: 20
volumes:
- retrom-pg:/var/lib/postgresql/data
retrom:
image: ghcr.io/jmberesford/retrom-service:v0.8.4
restart: unless-stopped
depends_on:
retrom-db:
condition: service_healthy
ports:
- "5101:5101"
volumes:
- ./library:/app/library
- ./config:/app/config
- retrom-data:/app/data
volumes:
retrom-pg:
retrom-data:
EOF
docker compose up -d
timeout 300 bash -c 'until curl -fsSL -o /dev/null http://localhost:5101/; do sleep 3; done'
# → http://SERVER_IP:5101 — the Retrom web client with an empty library; there is no login, so keep the port on a trusted networkRetrom's wiki flags these before you rely on it:
Retrom used 144 MB of RAM at idle on GCP e2-standard-2 · Ubuntu 26.04 LTS · Docker 29.9.3 (first boot, measured Nov 2026). We list a minimum of 512 MB.
The Retrom install snippet is marked verified on Ubuntu 26.04 (Nov 2026).