Documentation Index
Fetch the complete documentation index at: https://mintlify.com/chrisbenincasa/tunarr/llms.txt
Use this file to discover all available pages before exploring further.
Tunarr is distributed as a Docker image and as standalone pre-built binaries. Docker is the recommended installation method for most users because it bundles FFmpeg and simplifies upgrades. Standalone binaries are available for Linux, macOS, and Windows when Docker is not an option.
Docker
Tunarr is published to both Docker Hub and the GitHub Container Registry (GHCR). All Docker images ship with FFmpeg 7.1.1 pre-installed, so no separate FFmpeg setup is needed.Choose a tag based on how much stability you need:| Tag | Registry | Description |
|---|
latest | Docker Hub / GHCR | Most recent stable release. Recommended for production. |
x.x.x (versioned) | Docker Hub / GHCR | Pinned stable release (e.g. 1.1.0). Patch releases are added to the same line; major bumps signal breaking changes. |
dev | Docker Hub / GHCR | Latest pre-release build. Contains the newest features but may be unstable. |
x.x.x-dev.x | Docker Hub / GHCR | Specific pre-release build. |
chrisbenincasa/tunarr:latestchrisbenincasa/tunarr:dev
GHCR:
ghcr.io/chrisbenincasa/tunarr:latestghcr.io/chrisbenincasa/tunarr:dev
Switching from a latest or versioned tag to the dev tag is a one-way operation. Back up your entire Tunarr data directory before doing so — dev builds can include non-backwards-compatible database schema changes, and downgrading back to a stable release is not supported.
ARM builds (Raspberry Pi, Apple Silicon, etc.) are published under separate tags. Append -arm64 to any tag listed above to get the ARM image. For example: chrisbenincasa/tunarr:latest-arm64 or ghcr.io/chrisbenincasa/tunarr:dev-arm64.
Docker Compose
Create a docker-compose.yml with the following content, then run docker compose up -d:services:
tunarr:
image: chrisbenincasa/tunarr:latest
container_name: tunarr
ports:
- ${TUNARR_SERVER_PORT:-8000}:8000
environment:
- LOG_LEVEL=${TUNARR_LOG_LEVEL:-INFO}
# Replace with your local timezone for accurate guide data and scheduling.
- TZ=America/New_York
volumes:
# Map a host directory to /config/tunarr so data persists across restarts and upgrades.
- /path/to/tunarr/data:/config/tunarr
restart: unless-stopped
http://localhost:8000 once the container starts.Docker CLI
docker run \
-v "$(pwd)"/tunarr:/config/tunarr \
-e "TZ=America/New_York" \
-p 8000:8000 \
chrisbenincasa/tunarr
Docker Desktop
If you are using Docker Desktop, click the Optional settings button before running the container and configure the following:
- Volume bind mount — Set the container path to
/config/tunarr and the host path to the directory where you want Tunarr to store its data. This prevents data loss when the container restarts or is upgraded.
- Host port — Expose port
8000 (or any port of your choice) so you can reach the Tunarr web UI from your browser.
Unraid
Tunarr is available in the Unraid Community Apps store. After installing the Community Apps plugin, search for tunarr and select the app provided by grtgbln’s repository. Follow the on-screen instructions to map the web UI port and, optionally, pass through an Nvidia GPU or Intel iGPU for hardware transcoding. You can also map an existing dizqueTV configuration directory during setup to perform a migration.Standalone Binaries
Pre-built binaries are available for Linux (x64/ARM), Windows (x64), and macOS (x64/ARM):Unlike the Docker image, standalone binaries do not include FFmpeg. You must supply your own FFmpeg build. The recommended version is 7.1.1 using the pre-built binaries from ErsatzTV. Alternatively, builds from BtbN/FFmpeg-Builds or gyan.dev generally work as well. If you plan to use hardware acceleration, make sure your FFmpeg build includes the relevant libraries. Meilisearch Binary
Each Tunarr release includes a Meilisearch binary (meilisearch on Linux/macOS, meilisearch.exe on Windows) alongside the main Tunarr executable. You must keep both binaries in the same directory. Tunarr will not start correctly if it cannot locate the Meilisearch binary. When updating Tunarr, always replace both binaries together.
Linux and macOS
After downloading the binary, restore the executable permission:chmod +x ./tunarr-linux-x64
tunarr-linux-x64 with the actual filename for your platform and architecture.Windows
Download the .exe from the releases page and place it in a folder of your choice (for example, C:\Program Files\tunarr). No additional setup is required to run the binary directly; see the Running Tunarr page for instructions on installing it as a Windows service.Proxmox
If you run Proxmox, you can install Tunarr into an LXC container using the Tunarr Proxmox helper script. The script automates container creation, dependency installation, and initial setup. You can review the install script source before running it.
Run the following command from your Proxmox host shell:
bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/ct/tunarr.sh)"
