QuestarrNG

Snapetech QuestarrNG fork

QuestarrNG is Snapetech's maintained fork of Doezer/Questarr. It keeps the upstream game-management foundation and adds a substantial set of fork-maintained features: platform-aware discovery and library views, richer play tracking, post-processing and RomM imports, Playnite and SeerrNG integrations, optional PostgreSQL, and hardened multi-architecture releases. See What changed in QuestarrNG for the overview and the changelog for the release-by-release history.

Use ghcr.io/snapetech-org/questarrng:latest or the Compose file in this repository; the upstream Questarr image does not contain the SeerrNG provider routes. The fork image is published for linux/amd64 and linux/arm64 from main.

Support QuestarrNG on Ko-fi.

A video game management application inspired by the -Arr apps (Sonarr, Radarr, Prowlarr...) and GamezServer. Track and organize your video game collection with automated discovery and download management.

⭐ Star us on GitHub — your support motivates us a lot! 🙏😊

Table of Contents

• What this fork adds
• List of features
• Installation
• Screenshots
• Tech Stack
• Configuration
• Roadmap
• Troubleshooting
• Project Security & Documentation
• Contributing
• License
• Acknowledgments

What this fork adds

QuestarrNG continues to share its foundation with upstream Questarr. We maintain a separate fork because the current upstream main snapshot does not expose the SeerrNG provider contract. QuestarrNG adds that versioned, request-scoped integration while developing standalone library, acquisition, and deployment capabilities. Its maintained work has expanded in several areas. The fork guide records the comparison date, the differences, and the upstream capabilities that would let SeerrNG stop depending on this fork.

• A richer game library: platform-scoped discovery and filters, local library scanning, a Playing page with journal entries, milestones, screenshots and Steam achievements, plus DLC and expansion details.
• A complete acquisition path: Prowlarr and Torznab/Newznab search, configurable release selection, download monitoring, automated post- processing, safer archive extraction, and optional VirusTotal or ClamAV checks before import.
• External library workflows: mapped RomM imports, a Playnite extension for library sync and request-to-download, and a versioned SeerrNG catalog and PC acquisition API.
• More deployment choices: optional PostgreSQL alongside the default SQLite setup, multi-architecture images, a Windows service installer, and rootless container configurations with release attestations.

The fork changes guide summarizes these additions and their release history. The documentation map links to setup, integration, API, database, and security guides.

List of features

Supported Indexers/Downloaders

• Prowlarr synchronization is supported to add all your indexers at once.
• G4u.to: the site offers an API to VIP members, which can be used in Questarr.

SeerrNG integration

QuestarrNG provides SeerrNG with an IGDB catalog and request-scoped PC-game acquisition through a versioned, authenticated integration API. The contract keeps SeerrNG's request ID and selected OS/architecture attached to QuestarrNG's tracked game and download records. See docs/API.md for the catalog, status, retry, cancellation, and imported-file streaming routes. Cancellation stops only downloads safely correlated to the SeerrNG request; completed files remain on disk, and ambiguous active downloads are refused. If Questarr restarts during a handoff before recording its download, it pauses the request for a duplicate-download check before retrying or cancelling. The retry or cancel endpoint returns 409 with confirmationRequired until the caller checks the download queue/history and sends confirmNoExistingDownload: true. QuestarrNG 1.11.0 adds browser-local interface language selection and regional date and number formatting. It also advertises provider contract v2, preserves exact IGDB request identity, and can show verified Steam ownership and community play-time estimates. It supports authenticated multi-file bundles and can stage Real-Debrid downloads locally before import. Emulation acquisition remains unsupported. See the compatibility guide.

Import processing and file safety

Post-processing can move, copy, hardlink, or symlink completed downloads into your PC library, unpack supported archives, or route matched ROM imports into RomM folders. Optional VirusTotal hash checks and ClamAV scans run before unpacking or import. The import guide explains setup, platform-folder mappings, scanner behavior, and Pending Imports review.

Installation

Docker is the easiest way to deploy QuestarrNG with all dependencies included. SQLite is the default database; PostgreSQL is available as an optional backend. See docs/DATABASE.md before configuring PostgreSQL.

The optional Windows installer runs QuestarrNG as a Windows service and bundles its service host as a self-contained .NET 10 LTS executable. QuestarrNG itself is a Node.js application; the installer does not require a separate .NET runtime.

Supported architectures: released QuestarrNG Docker images are published for linux/amd64 and linux/arm64, so the app runs on a Raspberry Pi 4/5 with a 64-bit OS, other 64-bit ARM SBCs, and ARM-based NAS boxes as well as on x86 hardware. Docker selects the right architecture automatically — the commands below are identical on every platform. (32-bit ARM, e.g. armv7/a 32-bit OS on Raspberry Pi 3 and earlier, is not supported. The Home Assistant add-on is amd64-only.)

Option 1: Quick start (direct Docker)

mkdir -p ./data
docker run -d -p 5000:5000 --user "$(id -u):$(id -g)" \
  -e PUID="$(id -u)" -e PGID="$(id -g)" \
  -v ./data:/app/data --name questarrng ghcr.io/snapetech-org/questarrng:latest

Option 2: Docker Compose (more detailed)

1. Use the docker-compose.yml file from the repo or create a minimal one:

   services:
     app:
       image: ghcr.io/snapetech-org/questarrng:latest
       user: "${PUID:-1000}:${PGID:-1000}"
       ports:
         - "5000:5000"
       volumes:
         - ./data:/app/data
       environment:
         - SQLITE_DB_PATH=/app/data/sqlite.db
       restart: unless-stopped
   

2. Start the application:

   mkdir -p ./data
   PUID="$(id -u)" PGID="$(id -g)" docker compose up -d
   

3. Access the application: Open your browser to http://localhost:5000

The image runs as a non-root user by default. Set PUID and PGID to the owner of the mounted data directory; the Compose file uses those values as the container user. Existing installs keep their data and should set these values to the current owner. For a read-only container filesystem, drop all Linux capabilities, and block privilege escalation, use the docker-compose.hardened.yml overlay. It runs the app as the configured PUID:PGID directly, so prepare the bind-mounted ./data directory with that ownership before starting it.

1. Optional — use Postgres instead of SQLite:

   Questarr uses SQLite by default and needs no database configuration. If you would rather run it against Postgres, use the bundled compose file:

   POSTGRES_PASSWORD=$(openssl rand -hex 32) docker compose -f docker-compose.postgres.yml up -d
   

   Keep whatever password you pick — the same value must be supplied on every restart, and it must be safe to embed in a connection URL (a hex string from openssl rand -hex 32 always is).

   Switching an existing SQLite install to Postgres does not move your data — run scripts/sqlite-to-pg.ts to bring your library across. See docs/DATABASE.md.

Windows (installer)

Proxmox VE (LXC)

bash -c "$(curl --fail --silent --show-error --location --proto '=https' --proto-redir '=https' https://raw.githubusercontent.com/snapetech/QuestarrNG/main/scripts/proxmox/questarr-lxc.sh)"

UNRAID

CasaOS

Umbrel

Cosmos Cloud

Kubernetes (Helm)

git clone https://github.com/snapetech/QuestarrNG.git
cd QuestarrNG
helm install questarr charts/questarr --namespace questarr --create-namespace

kubectl port-forward -n questarr svc/questarr 5000:5000

Home Assistant Add-on

All platform definitions live in the repository and share the same mounts and ports — see docs/HOME_SERVER_APPS.md for details.

Screenshots

Tech Stack

• APIs: IGDB (game metadata), Torznab/Newznab (indexer search), PCGamingWiki, NexusMods, xREL.to
• AIs usage:
  • Claude and Github Copilot are used for AI-Assisted coding, internal code reviews, PR cleanup. Eventually automated coding and troubleshooting for small tasks and bug reports.
  • Gemini & Codex are used for automated code reviews, and brainstorming from time to time (as well as Perplexity for this usage).
  • Google Jules is used for light periodical refactoring.

Configuration

1. First-time setup:

• Create your admin account
• Configure the IGDB credentials

Once logged-in:

• Configure indexers
• Add downloaders
• Add games!

See the upstream Configuration Wiki for more detailed info.

git clone https://github.com/snapetech/QuestarrNG.git
cd QuestarrNG

docker-compose up -d

git pull
docker-compose down
docker-compose build --no-cache
docker-compose up -d

Roadmap

The original upstream roadmap is now partly delivered and partly superseded by fork work. Post-processing, indexer links, optional PostgreSQL, RomM import routing, and the Playnite and SeerrNG integrations are shipped. The remaining product proposals are version-aware game upgrades, debrid/direct-download providers, importing owned Steam or GOG libraries, and possible Gameyfin or user-defined webhook integrations. The maintained PRD marks what is shipped, what remains, and which ideas have no delivery commitment. The UI localization roadmap tracks current language and calendar coverage, plus the remaining screen-level translation and RTL work.

Troubleshooting

See the upstream Troubleshooting Wiki

If you run into an issue, go to the Logs page and click Send Logs before reporting it — it makes diagnosing the problem much easier.

Getting Help

• Issues: GitHub Issues
• Discussions: GitHub Discussions
• Discord: Join our Server

Project Security & Documentation

• What changed in the fork summarizes the maintained additions since the upstream baseline.
• Import processing and security scans explains RomM routing, archive handling, and optional malware checks.
• Start with docs/GITHUB_DOCUMENTATION.md for the full documentation map.

Contributing

• See .github/CONTRIBUTING.md for guidelines on how to contribute to this project.
• See MAINTAINERS.md for how repository access and release permissions are managed.

Contributors

Made with contrib.rocks.

Legal Disclaimer

QuestarrNG is a self-hosted game manager designed solely for organizing, tracking, and automating game libraries using user-provided data and metadata APIs (such as IGDB). QuestarrNG does not host, distribute, or provide any copyrighted game content, ROMs, or download links. It is a technology-neutral tool: any indexers, download clients, or sources you configure are chosen and operated entirely by you. You are solely responsible for ensuring that your use of QuestarrNG, and any content you access or download through third-party services you configure, complies with all applicable laws and the terms of service of those third parties.

License

GPL-3.0-only - see COPYING for the full license text.

Acknowledgments

• Inspired by Sonarr and GamezServer
• Game metadata powered by IGDB API
• UI components from shadcn/ui
• Security scanning supported by Snyk through the Snyk Open Source program
• AI code reviews by CodeRabbit, free for open source
• This project is tested with BrowserStack