Install on Unraid

ChannelWatch runs as a Docker container on Unraid. The app repo ships an Unraid XML template at deploy/unraid/channelwatch.xml; there is no separate native Unraid package.

Before you start

A current Unraid release with Docker enabled
Community Applications installed if you want template-based discovery or import
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.

Create the container in Unraid

Use the shipped template when it is available in your Unraid environment, or import the current XML from the app repo:

https://raw.githubusercontent.com/CoderLuii/ChannelWatch/main/deploy/unraid/channelwatch.xml

If the template is not available in Community Applications yet, create the container manually with Docker > Add Container and use the same values.

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.

Network mode

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.

Open the web UI

After the container starts, open:

http://your-unraid-ip:8501

Then complete First-Run Configuration.

Upgrading via Unraid

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.