Skip to content

Install on Unraid

ChannelWatch runs as a Docker container. These steps show how to run that container on Unraid. ChannelWatch does not have a native Unraid package.

  • A current Unraid release with Docker enabled
  • Community Applications installed if you want the easiest template discovery flow
  • A persistent appdata path, usually /mnt/user/appdata/channelwatch
  • A reachable Channels DVR server on your LAN

This page is an Unraid wrapper around the main Docker Compose guide. The image, ports, and /config volume stay the same.

If a community template exists in your environment, review it carefully before deploying. ChannelWatch does not ship an official Unraid template, so you may also need to create the container manually with Docker > Add Container.

Use these values:

  • Repository: coderluii/channelwatch:latest
  • AppData path: /mnt/user/appdata/channelwatch mapped to /config
  • Web UI port: 8501
  • Timezone: set TZ to your local IANA timezone

If your Unraid share permissions depend on a specific user, also set PUID and PGID so the container writes to appdata cleanly.

Host mode is the recommended default on Unraid because it avoids extra port mapping surprises and gives ChannelWatch the best chance of finding your Channels DVR server automatically.

If you prefer bridge mode, map 8501 manually and use your DVR server’s LAN IP in the web UI.

After the container starts, open:

http://your-unraid-ip:8501

Then complete First-Run Configuration.

Pull the updated image from the Docker tab, then restart the ChannelWatch container. As long as /mnt/user/appdata/channelwatch stays mapped to /config, your settings remain in place.