Core Settings
Core settings control the fundamental behavior of ChannelWatch: how it timestamps events, how much it logs, and which alert types are active. All of these are configured through the web UI at http://your-server-ip:8501 under Settings.
Settings reference
Section titled “Settings reference”| Setting | Default | Description |
|---|---|---|
| Timezone | America/Los_Angeles | IANA timezone used for all timestamps in notifications and logs |
| Log Level | Standard | Controls log verbosity: Standard (level 1) or Verbose (level 2) |
| Log Retention | 7 days | How long log files are kept before automatic cleanup |
| Channel Watching | Enabled | Live TV viewing notifications |
| VOD Watching | Enabled | Recorded content and library playback alerts |
| Recording Events | Enabled | Lifecycle alerts for scheduled, started, completed, and cancelled recordings |
| Disk Space | Enabled | Storage threshold alerts at warning and critical levels |
| Stream Counting | Enabled | Includes total active stream count in notifications |
Timezone
Section titled “Timezone”ChannelWatch uses the timezone you set here for all notification timestamps and log entries. The value must be a valid IANA timezone name — for example America/New_York, Europe/London, or Asia/Tokyo.
You can also set the timezone via the TZ environment variable in your compose file, which overrides the web UI value:
environment: TZ: "America/New_York"Log level
Section titled “Log level”Two levels are available:
- Standard (default) — logs connection events, alert dispatches, and errors. Suitable for normal operation.
- Verbose — adds detailed event processing, API call traces, and session lifecycle messages. Use this when troubleshooting unexpected behavior.
Verbose mode generates significantly more log output. Switch back to Standard once you’ve diagnosed the issue.
Log retention
Section titled “Log retention”ChannelWatch automatically deletes log files older than the configured retention period. The default is 7 days. Increase this if you want a longer audit trail; decrease it on low-storage systems.
Log files are stored at /config/logs/ inside the container (the directory you mounted as /config).
Alert toggles
Section titled “Alert toggles”Each alert type can be enabled or disabled independently. Disabling an alert type stops ChannelWatch from sending notifications for that category — it does not affect monitoring or logging.
| Alert type | What it covers |
|---|---|
| Channel Watching | Live TV streams on any tuner or client |
| VOD Watching | Playback of recorded content or DVR library items |
| Recording Events | Scheduled, started, completed, cancelled, and stopped recordings |
| Disk Space | Free space on the DVR storage path falling below configured thresholds |
For per-alert configuration options (which fields appear in notifications, cooldown timers, image sources), see the individual alert pages:
Stream counting
Section titled “Stream counting”When enabled, ChannelWatch includes the total number of active streams across all connected DVR servers in Channel Watching notifications. This gives you a quick sense of household activity at a glance.
API key
Section titled “API key”ChannelWatch v1.0 exposes a REST API at /api/v1/. By default the API is open on your local network. To require authentication, set an API key in Settings > Security. Once set, all API requests must include the key as a bearer token.
See API Keys for setup details.
Next steps
Section titled “Next steps”- DVR Connection — add and manage your Channels DVR servers
- Hot Reload — apply configuration changes without restarting the container