docker-tvheadend

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

Prerequisites

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 https://github.com/hobbsAU/docker-tvheadend.git
	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 \
 /bin/true

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 \
 hobbsau/tvheadend

You should see two new containers in the docker listing:

$ docker ps -a

Developing

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