Install on TrueNAS SCALE

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

Before you start

TrueNAS SCALE, not CORE
A dataset for persistent ChannelWatch data
Permission to deploy Docker or custom app workloads on your SCALE system
A reachable Channels DVR server on your LAN

Create a dataset for ChannelWatch

Create a dataset for persistent data, for example apps/channelwatch, then grant write access to the account or group your container runtime uses.

The important part is not the exact dataset name, it is making sure the container can write logs, backups, and settings.json without permission errors.

Deploy the container on SCALE

Use the Docker or custom app workflow available on your SCALE release and deploy the same ChannelWatch image used in the main Docker guide:

services:
  channelwatch:
    image: coderluii/channelwatch:latest
    container_name: channelwatch
    volumes:
      - /mnt/tank/apps/channelwatch:/config
    environment:
      TZ: "America/New_York"
      PUID: "1000"
      PGID: "1000"
    ports:
      - "8501:8501"
    restart: unless-stopped

If your SCALE setup exposes a compose editor, you can paste the snippet directly. Otherwise, mirror the same values in the app form fields.

Dataset permissions and ACLs

If the app starts but cannot save settings, fix the dataset ACLs first. ChannelWatch needs write access to the mounted /config path.

PUID and PGID are especially helpful here because they let you line the container process up with the user or group that owns the dataset.

Network configuration

Host networking is the easiest option when your SCALE release exposes it. If you stay with bridge networking, map port 8501 and use the DVR server’s LAN IP in the setup wizard.

Open the web UI

After deployment, open:

http://your-truenas-ip:8501

Then complete First-Run Configuration.

Upgrading

Pull the updated image in the SCALE app UI and redeploy with the same dataset mounted at /config.