binhex-tvheadend

binhex-tvheadend

Docker app from Binhex's Repository

Overview

Tvheadend is a TV streaming server and recorder for Linux, FreeBSD and Android supporting DVB-S, DVB-S2, DVB-C, DVB-T, ATSC, ISDB-T, IPTV, SAT>IP and HDHomeRun as input sources. Tvheadend offers the HTTP (VLC, MPlayer), HTSP (Kodi, Movian) and SAT>IP streaming. Multiple EPG sources are supported (over-the-air DVB and ATSC including OpenTV DVB extensions, XMLTV, PyXML).

Application

Tvheadend

Description

Tvheadend is a TV streaming server and recorder for Linux, FreeBSD and Android supporting DVB-S, DVB-S2, DVB-C, DVB-T, ATSC, ISDB-T, IPTV, SAT>IP and HDHomeRun as input sources. Tvheadend offers the HTTP (VLC, MPlayer), HTSP (Kodi, Movian) and SAT>IP streaming. Multiple EPG sources are supported (over-the-air DVB and ATSC including OpenTV DVB extensions, XMLTV, PyXML).

Build notes

Latest stable Tvheadend release from Arch Linux AUR.

Usage

docker run -d \
    -p 9981:9981 \
    -p 9982:9982 \
    --name=<container name> \
    -v <path for data files>:/data \
    -v <path for config files>:/config \
    -v /etc/localtime:/etc/localtime:ro \
    --device=/dev/<tuner type> \
    -e HEALTHCHECK_COMMAND=<command> \
    -e HEALTHCHECK_ACTION=<action> \
    -e HEALTHCHECK_HOSTNAME=<hostname> \
    -e UMASK=<umask for created files> \
    -e PUID=<uid for user> \
    -e PGID=<gid for user> \
    binhex/arch-tvheadend

Please replace all user variables in the above command defined by <> with the correct values.

Access HTTP

http://<host ip>:9981

Access HTSP

http://<host ip>:9982

Example

docker run -d \
    -p 9981:9981 \
    -p 9982:9982 \
    --name=tvheadend \
    -v /apps/docker/tvheadend/recorded:/data \
    -v /apps/docker/tvheadend:/config \
    -v /etc/localtime:/etc/localtime:ro \
    --device=/dev/dvb \
    -e UMASK=000 \
    -e PUID=0 \
    -e PGID=0 \
    binhex/arch-tvheadend

Notes

User ID (PUID) and Group ID (PGID) can be found by issuing the following command for the user you want to run the container as:-

id <username>

If you appreciate my work, then please consider buying me a beer :D

PayPal donation

Documentation | Support forum

Install binhex-tvheadend on Unraid in a few clicks.

Find binhex-tvheadend 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 binhex-tvheadend Review the template variables and paths Click Install

Download Statistics

200,358
Total Downloads
50
This Month
206
Avg / Month

Total Downloads Over Time

Loading chart...

Details

Repository
ghcr.io/binhex/arch-tvheadend
Last Updated2026-05-03

Runtime arguments

Web UI
http://[IP]:[PORT:9981]
Network
bridge
Shell
bash
Privileged
false
Extra Params
--device=/dev/tuner-type

Template configuration

Port: Web InterfacePorttcp

This is the Web UI port for the application.

Target
9981
Default
9981
Path: /configPathrw

This is the container path to your configuration files, e.g. databases, configuration files, logs etc.

Target
/config
Default
/mnt/user/appdata/tvheadend
Path: /dataPathrw

This is the container path to your downloaded files or user created content.

Target
/data
Variable: ENABLE_HEALTHCHECKVariable

Enable or disable healthchecks.

Target
ENABLE_HEALTHCHECK
Default
yes|no
Variable: HEALTHCHECK_COMMANDVariable

The command or script to execute, if not specified then the script healthcheck.sh will be used (process, dns and https checking).

Target
HEALTHCHECK_COMMAND
Variable: HEALTHCHECK_ACTIONVariable

The action to execute if the healthcheck command returns a non zero exit code, if not specified the action will be 'exit 1', if you want the container to exit on failure then set the action to 'kill 1'.

Target
HEALTHCHECK_ACTION
Variable: HEALTHCHECK_HOSTNAMEVariable

The hostname used when performing HTTPS and DNS healthchecking.

Target
HEALTHCHECK_HOSTNAME
Default
google.com
Variable: PUIDVariable

User ID for the running container

Target
PUID
Default
99
Variable: PGIDVariable

Group ID for the running container

Target
PGID
Default
100
Variable: UMASKVariable

UMASK for the running container

Target
UMASK
Default
000