Public | Automated Build

Last pushed: 22 days ago
Short Description
tvheadend master using lightweight Alpine Linux container (official)
Full Description


Run tvheadend from a docker container

Key features of this repository:

  • Efficiency - image is only ~25MB
  • Security - tvheadend runs as regular user and so does the docker image with the USER directive
  • Persistence - data-container used for config and recording persistence
  • Management - make script allows for easy configuration and ongoing maintenance


To use this package you must ensure the following:

  • Linux host system configured with Docker working
  • make installed (optional for management script)
  • git installed (optional for src and management script)

Installation - including management scripts and src

    git clone
    cd docker-tvheadend
    make run

Installation - standalone Docker image

docker pull hobbsau/tvheadend

Usage - using management scripts

Creating and running the container

$ make run

Stopping a running container

$ make stop

Starting a stopped container

$ make start

Destroying (deleting) a running or stopped container

$ make clean

Remotely trigger a container rebuild

$ make build

Usage - standalone Docker image

First let's setup the data container that will map the config directory from the host to the container as well as the recordings directory. This container will provide persistent storage.

$ docker create \
 --name tvheadend-data \
 -v <hostdir>:/config \
 -v <hostdir>:/recordings \
 hobbsau/tvheadend \

Example using my host and the /srv/tvheadend location on my host:

$ sudo docker create --name tvheadend-data -v /srv/tvheadend/config:/config -v /srv/tvheadend/recordings:/recordings hobbsau/tvheadend

Next we run the tvheadend-service and this will automatically map the volumes within the new container.

$ docker run -d \
 --restart=always \
 --net="host" \
 --volumes-from tvheadend-data \
 --name tvheadend-service \

You should see two new containers in the docker listing:

$ docker ps -a


The source repo is linked to dockerhub using autobuild. Any push to this repo will auto-update the docker image on docker hub.

Docker Pull Command
Source Repository