Up and Running in 60 Seconds

Three steps to your first alert

1. 1
   Create your compose file

   Create a docker-compose.yml in a new directory and paste the snippet below. Replace /your/local/path with the absolute path where ChannelWatch should store its config, and set TZ to your timezone (IANA format, e.g. America/Chicago or Europe/London).

   name: ChannelWatch
   services:
     channelwatch:
       image: coderluii/channelwatch:latest
       container_name: channelwatch
       init: true
       network_mode: host
       volumes:
         - /your/local/path:/config
       environment:
         TZ: "America/New_York"
       restart: unless-stopped

   All DVR connection settings are configured through the web UI after first launch. No environment variables are needed for DVR host or port.

2. 2
   Start the container

   From the directory containing your docker-compose.yml:

   docker compose up -d

   ChannelWatch will pull the latest image, create the container, and start in the background. Check the logs any time with docker logs -f channelwatch.

3. 3
   Open the web UI and add your DVRs

   Navigate to http://your-server-ip:8501 in a browser. The first-run wizard will guide you through connecting your Channels DVR server and choosing your notification providers.

   Configuration docs

Now what?