Skip to content

Troubleshooting

Jump to bottom
Doezer edited this page Jul 5, 2026 · 6 revisions

Common Issues

Search / discovery is disabled

  • Cause: Missing or invalid IGDB credentials.
  • Solution:
    1. Check for a red "Configuration Required" banner at the top of the dashboard.
    2. If you see a "Setup Required" screen on the Discover or Calendar pages, click "Go to Settings".
    3. Ensure valid Client ID and Secret are entered in Settings → IGDB API.
    4. If credentials were set via env vars, verify the Settings page shows a blue "Environment Variable" badge. UI-configured credentials take precedence.

Download status not updating

  • Cause: Cron jobs not running or hash mismatch between Questarr and the download client.
  • Solution:
    1. Check logs for "Checking download status" messages.
    2. Verify the torrent/usenet client connection in Settings → Downloaders (use "Test Connection").
    3. Make sure the category/label configured in Questarr matches the one in your download client.

Games added from Steam Wishlist are not syncing

  • Cause: Invalid Steam ID or private profile.
  • Solution:
    1. Go to Settings → Services and verify your Steam ID64 is correct.
    2. Ensure your Steam profile and wishlist are set to Public in Steam privacy settings.
    3. Check logs for errors from the Steam sync job.

NexusMods trending mods not showing

  • Cause: NexusMods API key not configured.
  • Solution: Go to Settings → Services and enter your NexusMods API key. You can generate one from your NexusMods account settings.

Schema mismatch / errors after upgrading from v1.2.2

  • Cause: Database schema did not migrate cleanly.
  • Solution: Questarr 1.3.0 includes an automatic Migration Repair that runs on startup. Check the logs for "Migration repair" messages. If errors persist, stop the container and run: 
    docker compose down
docker compose up
    and check the startup logs for migration output.

Port already in use

  • Cause: Another service using port 5000.
  • Solution: Change PORT in your docker launch command, docker-compose file, or .env to an available port (e.g., 5001).

Docker build fails

  • Cause: Out of disk space or corrupted layer cache.
  • Solution: 
    docker system prune -a
docker compose build --no-cache

SSL not working / HSTS redirect loop

  • Cause: APP_URL not set, or DISABLE_HSTS needed in a reverse-proxy setup.
  • Solution:
    1. Set APP_URL to your public HTTPS URL (e.g., https://questarr.example.com).
    2. If you handle TLS at the reverse proxy and do not want the app itself to redirect, set DISABLE_HSTS=true.

Check application health:

curl http://localhost:5000/api/health

Getting Help

Clone this wiki locally