Install in a Proxmox LXC Container

ChannelWatch runs as a Docker container. These steps show how to run that container inside a Proxmox LXC guest. ChannelWatch does not have a native Proxmox package.

Before you start

This is an advanced setup. If you are not already comfortable with Proxmox LXC, use a VM or the standard Docker Compose guide on a regular Linux host instead.

Create the LXC guest

Use a recent Debian or Ubuntu LXC template with enough CPU, memory, and disk for Docker plus your ChannelWatch config data.

For the least friction, enable the options required for Docker-in-LXC before you start installing packages.

Install Docker inside the guest

After the guest is ready, install Docker Engine and Docker Compose inside the LXC itself. Once Docker is working, deploy ChannelWatch the same way you would on any other Linux host.

services:
  channelwatch:
    image: coderluii/channelwatch:latest
    container_name: channelwatch
    network_mode: host
    volumes:
      - /opt/channelwatch/config:/config
    environment:
      TZ: "America/New_York"
    restart: unless-stopped

Persistent storage

Keep /config on storage that survives guest reboots and upgrades. A bind mount into the LXC is easier to inspect from Proxmox, while an internal Docker volume is simpler if you manage everything from inside the guest.

Network considerations

Host networking inside the LXC is the easiest option for reaching your Channels DVR server and for automatic discovery.

If you switch to bridge networking inside Docker, map port 8501 manually and use the DVR server’s LAN IP in the setup wizard.

Open the web UI

After the container starts, open:

http://your-lxc-ip:8501

Then complete First-Run Configuration.

Upgrading

Update Docker inside the LXC as needed, then pull the latest ChannelWatch image and restart the container.