hobbsau/tvheadend repository overview

⁠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.