Skip to content

Installation

Tunarr is available in two flavors: Docker image and standalone binaries.

Docker

Docker Pull Count

Tunarr is available on Docker Hub as well as GHCR. Docker images come pre-packaged with ffmpeg 7.1.1 (thanks @jasongdove from ErsatzTV!).

Since Tunarr is currently pre-release. There are a few tags to choose from which have different releae cadences:

  • x.x.x (versioned): These are stable release builds. In general, once a x.x.0 release is cut (e.g. 1.1.0), only bug fixes (patch releases) will be made to the release line. Major version bumps happen when backwards incompatible changes are made, particularly to the database.
  • latest: The latest tag points at the most recent, stable release build.
  • x.x.x-dev.x: These are pre-release build. Most new features are added on pre-releases before merged back to latest for a stable release.
  • dev: Points to the latest pre-release build. This build can be unstable. NOTE: If switching from a versioned/latest build to an dev build, it's recommended to take a backup of your entire Tunarr data directory. Downgrading from "dev" to a previous version is not supported; dev builds can contain non-backwards compatible changes, like database schema changes.

Docker Hub:

  • chrisbenincasa/tunarr:latest
  • chrisbenincasa/tunarr:dev

GHCR:

  • ghcr.io/chrisbenincasa/tunarr:latest
  • ghcr.io/chrisbenincasa/tunarr:dev

Currently ARM builds are published under separate tags. Take any of the tags above and append -arm64 to get a Docker image for ARM-based hosts.

Unraid

Tunarr is available in the Community Apps store on Unraid. After installing the Community Apps plugin on your Unraid machine, simply search for "tunarr" and select the resulting app (provided by grtgbln's repository).

Follow the on-screen instructions to set up the container, including mapping the Web UI port. You can optionally pass in an Nvidia GPU or Intel iGPU for hardware transcoding (use the proper corresponding Docker tag; enable "Advanced View" for more details), and optionally map an existing dizqueTV configuration directory to migrate (click "Show more settings...").

Synology

TODO! If you run Tunarr on Synology and would like to contribute a guide for Tunarr installation / setup, please reach out

Binaries

Tunarr is released in pre-built binaries for Linux (x64/ARM), Windows (x64), and macOS (x64/ARM). Tunarr currently does not provide a version of FFmpeg along with these binaries, so you must have your own build ready to go. We recommend using the pre-built FFmpeg 7.1.1 binaries provided by ErsatzTV. If these don't work, builds from BtbN/FFmpegBuilds or gyan.dev should generally work as well. If you are planning on using hardware acceleration, ensure that the build of FFmpeg you use includes the proper libraries built-in.

Proxmox

If you use Proxmox, you can easily install Tunarr into an LXC using the Tunarr Proxmox helper script. You can view the source here.