Cameras & RTSP Ingestion Configuration Reference
The cameras and rtsp sections define global ingest defaults and initial camera topology definitions.
1. Initial Cameras Configuration Block
yaml
# Global RTSP Ingest Settings
rtsp:
default_transport: "tcp" # options: tcp, udp
reconnect_interval_min: "1s"
reconnect_interval_max: "30s"
dial_timeout: "5s"
max_concurrent_dials: 10
# Initial Cameras (Seeded into BadgerDB on first boot)
cameras:
- id: "cam_entrance"
name: "Front Entrance"
url: "rtsp://admin:pass@192.168.1.100:554/live"
transport: "tcp"
enabled: true
recording_enabled: true
lazy_hls: false
folder_id: "perimeter"
tags:
- "outdoor"
- "entrance"
- "ptz"
- id: "cam_warehouse"
name: "Main Warehouse Floor"
url: "rtsp://admin:pass@192.168.1.101:554/live"
transport: "tcp"
enabled: true
recording_enabled: true
lazy_hls: true # On-demand ingest2. Camera Configuration Properties Reference
| Property | Type | Default | Description |
|---|---|---|---|
id | string | Required | Unique alphanumeric camera identifier (slug) |
name | string | "" | User-friendly display title in Web UI |
url | string | Required | Full RTSP URI (e.g. rtsp://user:pass@host:554/path) |
transport | string | "tcp" | RTSP transport mode (tcp or udp) |
enabled | boolean | true | Master enable toggle for the camera |
recording_enabled | boolean | false | Enable automated fMP4 video archiving |
lazy_hls | boolean | false | Ingest stream only when an active viewer is watching |
folder_id | string | "" | Identifier of parent folder group |
tags | list[string] | [] | Search and classification tags |