Install on Synology NAS

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

Before you start

DSM 7.2 or newer is the easiest path because it includes Container Manager
A writable shared folder for ChannelWatch data, such as /volume1/docker/channelwatch
A reachable Channels DVR server on your LAN

If you want the simplest install path, start with the base Docker Compose guide. This page focuses on the Synology-specific UI and permission details.

Open Container Manager

Open Container Manager in DSM. If you do not see it yet, install it from Package Center first.

Create a project folder for ChannelWatch in a shared location, for example:

/volume1/docker/channelwatch

Import the compose file

In Container Manager > Project, create a new project and paste the same compose file used in the Docker guide:

services:
  channelwatch:
    image: coderluii/channelwatch:latest
    container_name: channelwatch
    volumes:
      - /volume1/docker/channelwatch:/config
    environment:
      TZ: "America/New_York"
      PUID: "1026"
      PGID: "100"
    ports:
      - "8501:8501"
    restart: unless-stopped

Replace the timezone and volume path with values that match your NAS.

Match PUID and PGID to your Synology user

Synology often assigns user IDs that do not match the default Linux 1000:1000 pattern. Set PUID and PGID to the account that owns your ChannelWatch folder so the container can write settings.json, logs, and backups cleanly.

If you skip this step, the container may start but fail to write under /config.

Host vs bridge networking on Synology

Bridge mode with explicit port mapping is the safer default on Synology because host networking is not consistently exposed across all models and DSM builds.

If your Synology model and DSM build allow host networking, you can replace the ports block with network_mode: host. That is the easier option for DVR auto-discovery.

Open the web UI

After the project starts, open:

http://your-synology-ip:8501

Then follow First-Run Configuration to add your DVR, choose alert types, and set notification providers.

Upgrading

Container Manager can pull the latest coderluii/channelwatch:latest image and restart the project. Keep the /config bind mount pointed at the same Synology folder so settings, logs, and backups survive the upgrade.