RetroArr
★ 19About
Community Ratings
No ratings yetNew this week
Read recap →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.
netcupBest match
Full control
A small server, then Docker Compose.
About 20 minutes with Docker
Hetzner
Full control
A small server, then Docker Compose.
About 20 minutes with Docker
DigitalOcean
Full control
A small server, then Docker Compose.
About 20 minutes with Docker
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.