Try describing what you need:

RetroArr logo

RetroArr

★ 19
MIT LicenseOpen Source — No PaywallSingle Container — single container — minimal hosting footprintDocker · Compose · BinaryNo external DB2+ active committers (12mo)

About

RetroArr is a self-hosted game library manager aimed at people who want a Radarr/Sonarr-style workflow for video games. It targets PC games as well as retro consoles, handhelds, and arcade platforms,...

Community Ratings

No ratings yet

Features

  • Library scanning
  • Metadata fetching
  • Download automation
  • Indexer integration
  • Launch games from Steam and GOG
  • Browser-based retro emulation
  • Save states
  • Plugin system
  • Webhook notifications
  • Real-time status updates

Details

Last Updated
Nov 5, 2026
Created
Mar 14, 2026
Install Methods
dockerdocker-composebinary
Requirements
DockerSQLitePostgreSQLMariaDBRedis (optional)IGDB credentialsreverse proxy for optional HTTPS
Authentication
local
API
RESTWEBSOCKET
Backup & Export
file-backupnative-export
Runtime / Stack
Docker.NET
Privacy & Independence
Cloud: Optional
Deployment

Deployment: Docker Compose ✓Single Container — minimal hosting footprintsingle container

Run RetroArr yourself

Pick how much you want to manage.

1 more way to host

Some links earn us a commission. netcup pays us one and is our preferred VPS host.

Is this your project? Sponsor a listing

Run RetroArr with Docker Compose

Compose file from the RetroArr project repository.

1 service

no resource limits declared

needs persistent storage (4 volumes)

docker-compose.yml · @ a463964 · scanned Nov 3, 2026

services:
  retroarr:
    build: .
    container_name: retroarr
    ports:
      - "2727:2727"      # HTTP
      - "2728:2728"      # HTTPS (optional, remove if running behind a reverse proxy)
    volumes:
      - ./config:/app/config       # Logs are stored in ./config/logs/ by default
      - ./games:/media
      - ./downloads:/downloads
      - ./savestates:/app/savestates
    environment:
      - ASPNETCORE_ENVIRONMENT=Production
      - RetroArr_SAVESTATES_PATH=/app/savestates
      # https with a self-signed cert at ./config/certs/retroarr.pfx.
      # drop this if you proxy via swag/traefik/caddy with a real cert.
      # needed for psp/nds/n64/saturn/3do on a lan ip (SharedArrayBuffer).
      - RETROARR_HTTPS_PORT=2728
      # cidr ranges of trusted proxies. default covers rfc1918 + loopback.
      # - RETROARR_TRUSTED_PROXIES=10.0.0.0/8,172.16.0.0/12,192.168.0.0/16
    restart: unless-stopped
    networks:
      - arr-network
  # Optional: Include Prowlarr if not running separately
  # prowlarr:
  #   image: lscr.io/linuxserver/prowlarr:latest
  #   container_name: prowlarr
  #   environment:
  #     - PUID=1000
  #     - PGID=1000
  #     - TZ=Europe/Madrid
  #   volumes:
  #     - ./prowlarr-config:/config
  #   ports:
  #     - "9696:9696"
  #   restart: unless-stopped
  #   networks:
  #     - arr-network

networks:
  arr-network:
    driver: bridge

This file may be out of date. Check the RetroArr documentation for current setup steps.

Track your self-hosted stack

Bookmark software to try, rate tools you've used, and keep your collection in one place.

Metadata extracted from README on Oct 18, 2026

Alternatives to RetroArr

RomM logo

RomM

14.2k
A self-hosted ROM manager and player for scanning, enriching, browsing, and playing game collections.
Game Server PanelsCopyleft LicenseGames+2
6 Containers
Details
Retrom logo

Retrom

2.1k
A self-hosted game library and collection management service focused on emulation, with clients for managing, downloading, and playing games across devices.
Game Server PanelsCopyleft LicenseGames+2
Details
Gameyfin logo

Gameyfin

1.1k
Gameyfin is a web-based library manager for video games that scans game folders, fetches metadata and cover art, and lets users browse and download games from a browser.
Game Server PanelsCopyleft LicenseSelf Hosting Solutions+3
Details
Gaseous Server logo

Gaseous Server

956
Gaseous Server is the backend for the Gaseous system, providing ROM and title management with basic in-browser emulation.
Game Server PanelsCopyleft LicenseGames+2
2 Containers
Details
GameVault logo

GameVault

332
GameVault Backend is the server component of a self-hosted gaming platform for organizing DRM-free games on a file server.
Game Server PanelsGamesMedia Management+1
Source Available
Details
Ownfoil logo

Ownfoil

954
Ownfoil is a self-hosted Nintendo Switch library manager and shop that helps users organize content, identify missing DLC or updates, and browse/install content through a web interface and supported clients.
Game Server Panels
Details

Related Software

Lancache logo

Lancache

909
A Docker container for caching game downloads on a local network.
Game Server PanelsPermissive LicenseSelf Hosting Solutions+2
Details
Radarr logo

Radarr

14.7k
Radarr is a movie collection manager that monitors RSS feeds, interfaces with download clients and indexers, and automatically sorts, renames, and upgrades movie files.
Media ManagementCopyleft LicenseP2P File Sharing+2
Details
Watcharr logo

Watcharr

1.6k
Watcharr is a self-hosted watched-list app for tracking movies, TV shows, anime, and optionally video games.
Media ManagementSelf Hosting SolutionsGames+2
Details
Deleterr logo

Deleterr

339
Intelligent media library cleanup for Plex that automatically identifies and deletes media based on configurable rules.
Media ManagementAutomation ToolsSelf Hosting Solutions+1
Single Container
Details
auto-mcs logo

auto-mcs

506
A Minecraft server management app that helps users create, configure, import, and operate game servers with minimal setup.
Game Server PanelsCopyleft LicenseAutomation Tools+2
Single Container
Details
youtube-dl-nas logo

youtube-dl-nas

201
A NAS-friendly download queue for videos, audio, and subtitles that wraps yt-dlp with an authenticated web dashboard and REST API.
Media Management
Single Container
Details
Jellyfin logo

Jellyfin

59.0k
Jellyfin is a free software media server for managing and streaming personal media to client devices.
Multimedia StreamingCopyleft LicenseMedia Management+3
Details
RconCli logo

RconCli

690
A command-line client for sending RCON queries to remote Source dedicated game servers.
Game Server PanelsPermissive LicenseNetwork Utilities
Details
Houndarr logo

Houndarr

307
Houndarr automatically searches for missing or below-cutoff media across a arr stack using small, rate-limited batches.
Automation ToolsSelf Hosting SolutionsMedia Management
Single Container
Details
LinuxGSM logo

LinuxGSM

4.9k
LinuxGSM is a command-line tool for quick deployment and management of Linux dedicated game servers.
Game Server PanelsSelf Hosting SolutionsAutomation Tools+1
Details