Skip to main content

Docker

warning

If you want to use Windows or macOS, please run ErsatzTV natively instead. See Windows and macOS.

While it is possible to run ErsatzTV in Docker on a Windows or macOS host, it is not supported. Some features are known to be broken when running in Docker on platforms other than Linux, including:

  • Hardware acceleration
  • Scanning on macOS in Docker

You will not receive any support for running ErsatzTV in Docker on platforms other than Linux.

Docker Images​

Docker Pull Count

Latest Release​

  • jasongdove/ersatztv:latest
  • ghcr.io/ersatztv/ersatztv:latest

Development Release​

Development releases update much more frequently, but have the potential to be less stable than full releases.

  • jasongdove/ersatztv:develop
  • ghcr.io/ersatztv/ersatztv:develop

FFmpeg​

ErsatzTV depends on an up-to-date version of FFmpeg and FFprobe. Docker images are bundled with all required dependencies, including FFmpeg.

Docker​

1. Download the latest container image

docker pull ghcr.io/ersatztv/ersatztv

2. Create a directory to store configuration data

mkdir /path/to/config

3. Create and run a container

docker run -d \
  --name ersatztv \
  -e TZ=America/Chicago \
  -p 8409:8409 \
  -v /path/to/config:/config \
  -v /path/to/local/media:/path/to/local/media:ro \
  --restart unless-stopped \
  ghcr.io/ersatztv/ersatztv

4. To limit the writing to an SSD drive you can add a Temporary File System by adding this line to your docker container before the line ghcr.io/ersatztv/ersatztv

  --mount type=tmpfs,destination=/transcode \