Trackarr
Docker app from confinedfish's Repository
Trackarr is a self-hosted companion app for Radarr and Sonarr that gives you a unified view of your media automation.
Overview
Features include queue monitoring with health scoring, missing media tracking, multi-server support, background routines, and download history.
Setup: After starting the container, open the WebUI and add your Radarr/Sonarr servers under the Servers page. You will need the host, port, and API key for each instance.
Readme
View on GitHubTrackarr
A self-hosted companion app for Radarr and Sonarr that gives you a unified view of your media automation — downloads, queue health, missing media, and what needs your attention.
Alpha software — Trackarr is in early development. Expect breaking changes, incomplete features, and rough edges. It connects to live Radarr/Sonarr instances and can remove downloads and change quality profiles. Turn on Passive Mode (Settings > Servers) to watch without it changing anything. Use at your own risk.
Features
Queue monitoring — See active downloads across all your Radarr and Sonarr instances in one place. Track download progress, status changes, and stalled or failing items.
Health scoring — Every download gets a health score (0–100) based on how it's behaving. Stalls, errors and lack of progress lower it; recoveries and steady progress raise it. Downloads that are just waiting (queued, paused, waiting to import) aren't penalised. Configurable thresholds can flag or automatically remove unhealthy downloads, and you can protect any download so it's never removed.
Missing media tracking — Finds movies and episodes missing from your library and searches for them at a pace your indexers can handle: a limited number per run, longer waits after each unsuccessful search, and a fresh try later for items it gave up on. It can drop to a fallback quality profile to find something, and restores your original profile once the item downloads.
Multi-server support — Connect multiple Radarr and Sonarr instances, over HTTP or HTTPS, directly or through a reverse proxy. Each server gets its own health checks, uptime history and settings.
Server health and uptime — Heartbeat checks track each server's response time and uptime, surface Radarr/Sonarr's own health warnings, and automatically pause and resume servers that go offline.
Background routines — Scheduled jobs handle heartbeats, queue refreshes, health checks, missing media searches and database cleanup. Each routine keeps its own run history and can be paused, run by hand or rescheduled.
Download history — Browse past download attempts with event-level detail to understand what happened and why.
Installation
Docker Compose (recommended)
services:
trackarr:
container_name: trackarr
image: confinedfish/trackarr:latest
restart: unless-stopped
ports:
- "8585:8585"
volumes:
- ./docker-data/trackarr:/config
environment:
TZ: America/New_York # your time zone
PUID: 1000 # optional: user/group that owns /config (default 99:100)
PGID: 1000
docker compose up -d
Trackarr will be available at http://localhost:8585. The database, settings, logs and crash reports are stored in ./docker-data/trackarr/.
Docker CLI
docker run -d \
--name trackarr \
--restart unless-stopped \
-p 8585:8585 \
-v /path/to/config:/config \
-e TZ=America/New_York \
confinedfish/trackarr:latest
Unraid
- In the Unraid Docker tab, click Add Container
- Set Repository to
confinedfish/trackarr:latest - Under Template, you can use the Unraid template XML from this repo
- Check the port (default
8585), appdata path (default/mnt/user/appdata/trackarr) and time zone - Click Apply
Unraid will automatically detect when a new image is available on Docker Hub and offer to update the container.
Port, URL base and reverse proxies
The port, bind address, URL base (e.g. /trackarr) and reverse proxy settings live in Settings > Network, like
Radarr and Sonarr, not in Docker variables. They apply after a restart. If you change the port, change the container
side of the port mapping to match.
Behind a reverse proxy, turn on Trust forwarded headers. Leave Trusted Proxies empty to trust proxies on private networks (the usual Docker or LAN setup), or list your proxy's IP or range.
Upgrading from an older template that set ASPNETCORE_URLS? It still works and overrides the port setting. Remove it
(and update the port mapping) to use the Network settings.
Connecting to Radarr/Sonarr over HTTPS
- Through a reverse proxy (e.g.
https://example.com/radarr): paste the full URL into the host field and Trackarr fills in HTTPS, port 443 and the URL base. - Radarr/Sonarr's own SSL (Settings > General > Use SSL, port 9898 by default): turn on Use SSL, set the port, and turn on Skip certificate validation, since that certificate is self-signed.
If a connection fails, the error now says why (certificate problem, connection refused, host not found, timeout).
Updating
A new image is published to Docker Hub only when there's a release. To update:
- Docker Compose:
docker compose pull && docker compose up -d - Docker CLI:
docker pull confinedfish/trackarr:latestand recreate the container - Unraid: Click the update notification in the Docker tab
latest is always the newest release. To stay on one major version, use its number instead (for example
confinedfish/trackarr:6), or pin an exact version such as 6.0.1. Release notes are on the
Releases page and in Trackarr under System > Releases.
First-time setup
- Open Trackarr in your browser
- Go to Servers and add your Radarr/Sonarr instances (you'll need the host, port, and API key for each)
- Background routines will start syncing queue and missing media data automatically
Configuration
Trackarr stores its settings in the database and exposes them through the UI. Key configuration areas:
| Category | Examples |
|---|---|
| General | App name, routine scheduling, default server type |
| Network | Port, bind address, URL base, reverse proxy trust, outgoing proxy |
| Server defaults | Queue monitoring, auto-remove, Passive Mode, missing media search, connection timeout |
| Health policy | Starting score, penalty/reward weights, removal thresholds, grace periods, recovery protection |
| Missing policy | Search cooldown, searches per run, failed searches before a fallback profile, episode cascade, abandon and retry |
| Display | Date/time format, table page sizes, chart visibility, table density |
Each server can also override the defaults (timeout, queue monitoring, auto-remove, missing search) and has its own fallback quality profile, URL base and HTTPS options.
Development
Requirements: .NET 10.0 SDK
git clone https://github.com/alexzeigler/Trackarr.git
cd Trackarr
dotnet run --project Trackarr/Trackarr.csproj
The development launch profile starts the app at http://localhost:5264 (it sets ASPNETCORE_URLS, which overrides
the port in Settings > Network). Without it, Trackarr listens on port 8585. The database is created automatically on
first run, in Trackarr.Data/ during development.
Running tests:
dotnet test
Branches and releases: work goes into develop through pull requests, and releases are version tags on
master. See docs/RELEASING.md.
Mock server: the maintainer tests against real Radarr/Sonarr data with the Trackarr MockServer, which lives in a separate private repository. It forwards reads to the live servers and intercepts searches, removals and other writes, so Trackarr can be pointed at it without changing anything.
Project structure
Trackarr/ Web app: Blazor Server UI, startup, hosting and network settings
Trackarr.Core/ Domain models: media, health, queue, routines, settings
Trackarr.Data/ EF Core DbContext and migrations (SQLite)
Trackarr.Services/ Business logic: Radarr/Sonarr API client, health scoring, missing search
Trackarr.Routines/ Background jobs (heartbeat, queue, evaluation, missing media, cleanup)
Trackarr.Tests/ Unit and integration tests (xUnit)
deploy/unraid/ Unraid container template
Tech stack
- .NET 10 / ASP.NET Core / Blazor Server
- SQLite via Entity Framework Core
- Tabler and Bootstrap for the UI, ApexCharts for charts
- xUnit for testing
Contributing
Trackarr is not yet set up for outside contributions. Once the first alpha builds are more stable, bug reports, testing feedback, and setup experience reports will be the most useful.
Built with AI
Trackarr is developed with heavy use of AI. A large share of the code — including most of the v5.2 reliability fixes, the network and HTTPS work, the cleanup, and many of the tests — was written by Claude, an AI model made by Anthropic, working in Claude Code. The maintainer decides what gets built, directs and reviews the changes, tests them against real Radarr and Sonarr setups, and makes every release.
That shapes how much you should trust it:
- AI-written code can contain mistakes that look correct. There's an automated test suite (around 570 tests), but tests only cover what someone thought to check.
- Trackarr can remove downloads, blocklist releases and change quality profiles on your Radarr and Sonarr. Start with Passive Mode on and watch what it would do before letting it act.
- If something looks wrong, please open an issue. Reports from real setups are what catch the problems tests miss.
Disclaimer
Trackarr is an independent project, not affiliated with Radarr, Sonarr, Anthropic, or any download client.
Categories
Download Statistics
Related apps
Explore more like this
Explore allLinks
Details
confinedfish/trackarr:latestRuntime arguments
- Web UI
http://[IP]:[PORT:8585]/- Network
bridge- Shell
bash- Privileged
- false
Template configuration
Port for the Trackarr web interface. If you change Trackarr's port in Settings > Network, change the container port here to match.
- Target
- 8585
- Default
- 8585
- Value
- 8585
Path to store Trackarr configuration and database.
- Target
- /config
- Default
- /mnt/user/appdata/trackarr
- Value
- /mnt/user/appdata/trackarr
User ID Trackarr runs as; files in /config are owned by it. 99 = nobody on Unraid.
- Default
- 99
- Value
- 99
Group ID Trackarr runs as. 100 = users on Unraid.
- Default
- 100
- Value
- 100
Time zone for times shown in the UI, e.g. America/New_York. Use the same value as your other containers.
- Target
- TZ
- Default
- Etc/UTC
- Value
- Etc/UTC