Sportarr

Sportarr

Official

Docker app from Sportarr's Repository

Overview

Sportarr is a sports PVR for Usenet and BitTorrent users. It monitors sports leagues and events across hundreds of sports worldwide (fighting sports, football, soccer, basketball, motorsports, and more), searches your indexers for releases, and will grab, sort, and rename them, upgrading quality automatically when a better format becomes available. Multi-part event support handles prelims and main cards for fighting sports, an IPTV DVR can record events straight from live streams, and dedicated metadata agents keep Plex, Jellyfin, and Emby libraries correctly identified (Kodi reads local metadata natively, no agent needed). Subtitles via Bazarr, notifications via Discord, Telegram, Slack, Mattermost, Pushover, Gotify, Join, Pushbullet, SimplePush, email, ntfy, Apprise, webhooks, or custom scripts.

License Discord online

Sportarr

Sports PVR for Usenet and Torrents

Like Sonarr & Radarr, but for sports events. Monitors sports leagues, searches your indexers
for releases, and handles file renaming, organization, and media server integration.

Website Docker Docker pulls Architecture Latest release Stars

Support the Project

Sponsor Ko-fi Bitcoin


Sportarr Dashboard

What It Does

  • Tracks events across all major sports (fighting sports, football, soccer, basketball, racing, etc.)
  • Searches Usenet and torrent indexers automatically and upgrades quality when better releases appear
  • Organizes files with customizable naming schemes, including multi-part events for fighting sports
  • Integrates with Plex, Jellyfin, and Emby through dedicated metadata agents
  • Records live events from IPTV sources with automatic scheduling (alpha)
  • Fetches subtitles through Bazarr and notifies via Discord, ntfy, Apprise, webhooks, or custom scripts

Quick Start

version: "3.8"
services:
  sportarr:
    image: sportarr/sportarr:latest
    container_name: sportarr
    environment:
      - PUID=99
      - PGID=100
      - UMASK=022
      - TZ=America/New_York
    volumes:
      - /path/to/sportarr/config:/config
      - /path/to/data:/data
    ports:
      - 1867:1867
    restart: unless-stopped

Open http://your-server-ip:1867 and follow the Initial Setup guide.

Not on Docker? Native builds for Windows, macOS, and Linux are on the releases page, and Sportarr is in the TrueNAS SCALE, HexOS, and Unraid app catalogs. Full details in the installation guide.

Documentation

Everything lives on the wiki at wiki.sportarr.net:

Support

Project Activity

Repobeats analytics

Star History

Star History Chart

Contributors

Sportarr is made better by everyone who has contributed code. Thank you.

BenjaminDecreusefond
BenjaminDecreusefond
ohathar
ohathar
hobbithau5
hobbithau5
mmmmmtasty
mmmmmtasty
FacePlant101
FacePlant101
gwyden
gwyden
abcattell91
abcattell91
gerrewsb
gerrewsb
nickperkins
nickperkins
scottrobertson
scottrobertson
afrancke
afrancke
benjamin-decreusefond
benjamin-decreusefond
Donai82
Donai82
gilesw
gilesw
jpaull-nz
jpaull-nz
kristofferR
kristofferR
lustered
lustered
lyrova-andy
lyrova-andy
nathanjcollins
nathanjcollins
Percentnineteen
Percentnineteen
Pukabyte
Pukabyte
schlort
schlort
skjaere
skjaere
slflowfoon
slflowfoon

See the full contributor graph, plus everyone helping with testing and bug reports on Discord.

Sponsors

Sportarr is free and self-funded. If it saves you time, a one-time or monthly contribution keeps it moving, and every supporter shows up here.

Backers

Sponsors


Sportarr is supported by:

HexOS

License

GNU GPL v3 - see LICENSE.md and COPYRIGHT.md.

Acknowledgements

Sportarr began as a fork of Sonarr in October 2025. The application was rewritten shortly afterwards and the great majority of the code here is original, but parts of it are still derived from Sonarr and the project would not exist without the years of work that went into it first.

Thank you to the Sonarr Team and everyone who has contributed to Sonarr. Their copyright notices are retained in COPYRIGHT.md, and Sportarr is released under the same GPL-3.0 license.

Install Sportarr on Unraid in a few clicks.

Find Sportarr in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.

Open the Apps tab on your Unraid server Search Community Apps for Sportarr Review the template variables and paths Click Install

Requirements

SQLite works out of the box with zero database configuration. To use PostgreSQL instead (fresh installs only), click **Show more settings...** to reveal the database **Variables**.

Download Statistics

434,669
Total Downloads
109,540
This Month
63,608
Avg / Month

Total Downloads Over Time

Loading chart...

Related apps

Explore more like this

Explore all

Details

Repository
sportarr/sportarr:latest
Last Updated2026-08-25
First Seen2026-01-15

Runtime arguments

Web UI
http://[IP]:[PORT:1867]
Network
bridge
Shell
sh
Privileged
false

Template configuration

Port: Web InterfacePorttcp

This is the Web UI port for the application.

Target
1867
Default
1867
Value
1867
Path: /configPathrw

This is the container path to your configuration files, e.g. database, settings, logs.

Target
/config
Default
/mnt/user/appdata/sportarr
Value
/mnt/user/appdata/sportarr
Path: /dataPathrw

This is the container path to your media library root. Add your sports library as a root folder inside Sportarr under this mount, and keep downloads under the same mount for hardlinked imports.

Target
/data
Default
/mnt/user/data
Value
/mnt/user/data
Variable: PUIDVariable

User ID for the running container (99 = nobody).

Target
PUID
Default
99
Value
99
Variable: PGIDVariable

Group ID for the running container (100 = users).

Target
PGID
Default
100
Value
100
Variable: UMASKVariable

UMASK for files created by the container.

Target
UMASK
Default
022
Value
022
Variable: TZVariable

Timezone, e.g. America/New_York. Keeps event air times and the calendar correct.

Target
TZ
Default
UTC
Value
UTC
Variable: Sportarr__Database__ProviderVariable

Database provider: sqlite (default, zero config) or postgres. PostgreSQL is for fresh installs only; there is no SQLite to Postgres migration path.

Target
Sportarr__Database__Provider
Default
sqlite
Value
sqlite
Variable: Sportarr__Database__HostVariable

PostgreSQL server hostname. Only used when the provider is postgres.

Target
Sportarr__Database__Host
Variable: Sportarr__Database__PortVariable

PostgreSQL port. Only used when the provider is postgres.

Target
Sportarr__Database__Port
Default
5432
Value
5432
Variable: Sportarr__Database__NameVariable

PostgreSQL database name. Only used when the provider is postgres.

Target
Sportarr__Database__Name
Default
sportarr
Value
sportarr
Variable: Sportarr__Database__UsernameVariable

PostgreSQL user. Only used when the provider is postgres.

Target
Sportarr__Database__Username
Variable: Sportarr__Database__PasswordVariable

PostgreSQL password. Only used when the provider is postgres. Any Sportarr__ variable can instead be read from a file by prefixing it with FILE__ and pointing the value at the file path (Docker secrets).

Target
Sportarr__Database__Password
Variable: Sportarr__Database__ConnectionStringVariable

Full PostgreSQL connection string; overrides the individual database fields above when set.

Target
Sportarr__Database__ConnectionString