coderluii/channelwatch

ChannelWatch

ChannelWatch is a self-hosted monitoring and notification dashboard for Channels DVR.

It watches DVR activity, recording events, VOD playback, disk space, and service health from a single container. The v0.9 release adds multi-DVR setup, first-run discovery, per-DVR status, notification routing, delivery history, backup and restore, health checks, metrics, an in-app Update Center, and a maintained Unraid template.

Images

• Docker Hub: coderluii/channelwatch
• GHCR: ghcr.io/coderluii/channelwatch

Recommended tags:

• latest for the newest stable image
• 0.9.15 for the v0.9.15 release

Quick Start

yaml
services:
  channelwatch:
    image: coderluii/channelwatch:latest
    container_name: channelwatch
    ports:
      - "8501:8501"
    volumes:
      - ./config:/config
    environment:
      TZ: America/Los_Angeles
      CHANNELWATCH_SECRET_STORAGE_KEY: "${CHANNELWATCH_SECRET_STORAGE_KEY:?set a unique value of at least 32 characters}"
      PUID: "1000"
      PGID: "1000"
    restart: unless-stopped

Open http://localhost:8501 after the container starts.

Updating

Use v0.9.15 or latest for the current v0.9 release. It improves Update Center restart recovery and strengthens the privacy of public problem-report previews.

After installing a version with Update Center support through Docker, Unraid, Compose, or Helm, compatible app-only releases can be checked, verified, backed up, applied, and rolled back from Settings > Updates.

v0.9.15 requires no settings or data migration and can be installed through Settings > Updates from v0.9.14 without replacing the container image. The first transition from v0.9.14 may require one manual browser refresh after ChannelWatch restarts. Docker, Unraid, Compose, and Helm updates remain available if preferred.

Releases that change the container runtime still require a normal image update. ChannelWatch will show container image update required when that is the safe path.

Configuration

ChannelWatch stores its settings, logs, database, backups, and encryption key under /config. Set CHANNELWATCH_SECRET_STORAGE_KEY to a unique value of at least 32 characters so new local secret files are written with envelope encryption.

DVR setup is easiest through the web UI. For bootstrap-only deployments, CHANNELS_DVR_SERVERS supports comma-separated Name@host:port entries.

Links

• Project: https://github.com/CoderLuii/ChannelWatch
• Support: https://github.com/CoderLuii/ChannelWatch/discussions
• Documentation: [***]