bigbeardedman/gadarr repository overview

⁠Gadarr

Gadarr is a self-hosted, game-native Arr-style app for tracking PC games, searching releases, monitoring download queues, and importing completed downloads into a finished games library.

This image serves the Fastify API and built web UI in one container. SQLite data is stored outside the image under /config.

⁠Quick Start

docker pull bigbeardedman/gadarr:testing

docker run -d \
  --name gadarr \
  --restart unless-stopped \
  -p 9787:9787 \
  -v /path/to/gadarr/config:/config \
  -v /path/to/games:/games \
  -v /path/to/downloads:/downloads \
  -v /path/to/shared-media:/data:ro \
  -e GADARR_AUTH_METHOD=forms \
  bigbeardedman/gadarr:testing

Open http://<host>:9787 and create the first Forms login.

⁠Tags

• testing: latest image published from main
• sha-<short-sha>: immutable image for a specific commit
• version tags: available after release tags are created

For production or NAS deploys, prefer an immutable sha-<short-sha> tag.

⁠Volumes

• /config: database, generated keys, backups, and app state
• /games: finished game library
• /downloads: download staging path shared with clients
• /data: optional read-only shared root for completed paths reported by download clients

⁠Synology Notes

For Synology Container Manager, mount /volume1/docker/appdata/gadarr to /config, /volume1/Files/Games to /games, /volume1/plexmedia/downloads to /downloads, and /volume1/plexmedia to /data:ro.

⁠Security

Do not bake secrets into images. Configure API keys, calendar feed keys, Prowlarr credentials, and reverse proxy settings with environment variables or the persistent /config volume. Keep Gadarr LAN/VPN-only until authentication, backups, and restore flow are verified.