All apps · 0 apps

Sportarr

Official

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. Subtitles via Bazarr, notifications via Discord, ntfy, Apprise, webhooks, or custom scripts.

Readme

View on GitHub

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.

Support the Project

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/sports:/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:

Installation and Initial Setup
Integrations: Prowlarr, Bazarr, Maintainerr, Homepage, autobrr, and the media server agents
IPTV DVR recording
Troubleshooting
Application API for tools integrating with Sportarr, and the live metadata API explorer
Building from source

Support

Discord - best place for quick help
GitHub Issues - bug reports and feature requests
GitHub Discussions - general questions

Project Activity

Repobeats analytics

Star History

Contributors

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

_{BenjaminDecreusefond}	_ohathar	_mmmmmtasty	_FacePlant101	_gwyden	_abcattell91
_gerrewsb	_{scottrobertson}	_afrancke	_{benjamin-decreusefond}	_Donai82	_gilesw
_hobbithau5	_jpaull-nz	_kristofferR	_lustered	_lyrova-andy	_{nathanjcollins}
_nickperkins	_{Percentnineteen}	_Pukabyte	_schlort	_skjaere	_slflowfoon

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

License

GNU GPL v3 - see LICENSE.md

Sportarr is based on Sonarr. Thanks to the Sonarr team for the foundation.

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

Explore Unraid OS

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**.

Related apps

Explore more like this

Explore all

Downloaders Video apps

Links

Projectsportarr.net Supportdiscord.gg Docker Hubhub.docker.com Templateraw.githubusercontent.com

Details

Repository

sportarr/sportarr:latest

Registry

https://hub.docker.com/r/sportarr/sportarr

Last Updated2026-06-30

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

Library

Curated

Categories