WORK IN PROGRESS
WORK IN PROGRESS
WORK IN PROGRESS
Managing security cameras - recording, detection, notifications.
Frigate is a software NVR - network video recorder.
Simple, clean web-based interface with possible integration in to home assistant
and its app.
Frigate offers powerful AI object detection, by using OpenCV and Tensorflow. In contrast to cameras of old time which just detect movement, Frigate can recognize if object in view is a cat, a car or a human.
This detection is cpu heavy and to ease the load,
Google Coral TPU
is recommended if planning to run multiple cameras with detection.
Recently
OpenVINO
has been integrated, which should allow use of igpu of intel 6th+ gen cpus
as a detector.
Though my testing with intel igpu OpenVINO going by official docs results in miniPC that runs frigate freezing once a day. In comments there seems to be solution by switching to
Open source, written in Python and JavaScript.
/home/
└── ~/
└── docker/
└── frigate/
├── 🗁 frigate_config/
| └── 🗋 config.yml
├── 🗁 frigate_storage/
├── 🗋 .env
└── 🗋 docker-compose.yml
frigate_storage/- storage for frigate database, and video recordingsconfig.yml- main frigate config file.env- a file containing environment variables for docker composedocker-compose.yml- a docker compose file, telling docker how to run the containers
You need to create frigate_config directory and in it create config.yml.
Also you need to provide the compose file and the .env file.
This docker compose is based off the official one except few changes.
Using bind mounts instead of volumes, moved variables to the .env file,
commented out privileged mode, increased shm_size,...
Of note is use of tmpfs for ram temp storage
and shm_size.
In version 13, docker compose deployment is in the way that entire directory is mounted in, not just config file. Make not of it.
docker-compose.yml
services:
frigate:
image: ghcr.io/blakeblackshear/frigate:0.13.0-beta7
container_name: frigate
hostname: frigate
restart: unless-stopped
env_file: .env
# privileged: true
shm_size: "256mb"
volumes:
- /etc/localtime:/etc/localtime:ro
- ./frigate_config:/config
- ./frigate_storage:/media/frigate
- type: tmpfs # 1GB of memory
target: /tmp/cache
tmpfs:
size: 1000000000
ports:
- "5000:5000" # Web GUI
- "8554:8554" # RTSP feeds
- "8555:8555/tcp" # WebRTC over tcp
- "8555:8555/udp" # WebRTC over udp
networks:
default:
name: $DOCKER_MY_NETWORK
external: true.env
# GENERAL
DOCKER_MY_NETWORK=caddy_net
TZ=Europe/Bratislava
# FRIGATE
FRIGATE_RTSP_USER: "admin"
FRIGATE_RTSP_PASSWORD: "dontlookatmekameras"All containers must be on the same network.
Which is named in the .env file.
If one does not exist yet: docker network create caddy_net
Caddy is used, details
here.
Caddyfile
cam.{$MY_DOMAIN} {
reverse_proxy frigate:5000
}
- PoE - power over ethernet, camera is powered by the same cat cable that carries data. You want POE(802.3af) or POE+(802.3at), none of the passive poe by mikrotik or ubiquity.
- onvif - attempt at industry standard for security cameras, nvr,.. regardless of manufacturer
- rtsp - a protocol for streams
- ptz - Pan-Tilt-Zoom allows remote movement of a camera
- mqtt - messaging protocol to communicate with home assistant
Connect camera to your network.
Find url of your camera streams, either by googling your model,
or theres a handy windows utility -
onvif-device-manager.
Unfortunately all official urls seem dead,
this
worked for me and passed virustotal at the time. There are also comments
with some links at its sourceforge page.
Camera discovery of onvif-device-manager is almost instant, if the camera requires
credentials, set them in the top left corner.
In live view there should be stream url displayed. Like: "rtsp://10.0.19.171:554/stream1"
Ideally your camera has several streams A primary one in full resolution full frame rate for recording, and then secondary one in much smaller resolution and fps for observing.
Example bare config that should shows camera stream once frigate is running.
This one has credentails contained in the url - rtsp://username:password@ip:port/url
frigate_config/config.yml
mqtt:
enabled: false
cameras:
C1-Whatever:
ffmpeg:
inputs:
- path: rtsp://{FRIGATE_RTSP_USER}:{FRIGATE_RTSP_PASSWORD}@10.0.19.171:554/stream1All that is there is disabled mqtt since no home assistant yet
and just single camera stream that pulls credentails from the .env file.
Now to also record main stream and detect on substream.
mqtt:
enabled: false
detectors:
default_detector_for_all:
type: cpu
objects:
track:
- person
- cat
- dog
cameras:
K1-Brana:
ffmpeg:
inputs:
- path: rtsp://{FRIGATE_RTSP_USER}:{FRIGATE_RTSP_PASSWORD}@10.0.19.171:554/stream1
roles:
- record
- path: rtsp://{FRIGATE_RTSP_USER}:{FRIGATE_RTSP_PASSWORD}@10.0.19.171:554/stream2
roles:
- detect
detect:
width: 640
height: 480
fps: 5
snapshots:
enabled: True
bounding_box: True
record:
enabled: True
retain:
days: 1
motion:
mask:
- 0,480,186,480,174,226,173,0,0,0with intel igpu openvino mqtt ntfy
Previously when I tried openvino igpu hw acceleration I had the server daily freeze. Now I setup this config expecting freezes and getting ready to try yolo model from github comments, but no freeze yet for few days..
mqtt:
enabled: true
host: 10.0.19.40
port: 1883
user: frigate
password: ${FRIGATE_RTSP_PASSWORD}
detectors:
ov:
type: openvino
device: AUTO
model:
path: /openvino-model/ssdlite_mobilenet_v2.xml
model:
width: 300
height: 300
input_tensor: nhwc
input_pixel_format: bgr
labelmap_path: /openvino-model/coco_91cl_bkgr.txt
objects:
track:
- person
- cat
- dog
filters:
person:
min_area: 1000
threshold: 0.70
cat:
min_area: 200
threshold: 0.5
ffmpeg:
hwaccel_args: preset-vaapi
detect:
max_disappeared: 2500
cameras:
K1-Brana:
birdseye:
order: 1
ffmpeg:
inputs:
- path: rtsp://{FRIGATE_RTSP_USER}:{FRIGATE_RTSP_PASSWORD}@10.0.19.41:554/stream1
roles:
- record
- path: rtsp://{FRIGATE_RTSP_USER}:{FRIGATE_RTSP_PASSWORD}@10.0.19.41:554/stream2
roles:
- detect
detect:
width: 640
height: 480
fps: 5
snapshots:
enabled: True
bounding_box: True
record:
enabled: True
retain:
days: 1
motion:
mask:
- 640,480,640,0,0,0,0,480,316,480,308,439,179,422,162,121,302,114,497,480
K2-Pergola:
birdseye:
order: 2
ffmpeg:
inputs:
- path: rtsp://{FRIGATE_RTSP_USER}:{FRIGATE_RTSP_PASSWORD}@10.0.19.42:554/stream1
roles:
- record
- path: rtsp://{FRIGATE_RTSP_USER}:{FRIGATE_RTSP_PASSWORD}@10.0.19.42:554/stream2
roles:
- detect
detect:
width: 640
height: 480
fps: 5
snapshots:
enabled: True
bounding_box: True
record:
enabled: True
retain:
days: 1
motion:
mask:
- 640,78,640,0,0,0,0,480,316,480,452,171
K3-Dvor:
birdseye:
order: 3
ffmpeg:
inputs:
- path: rtsp://10.0.19.43:554/0/av1
roles:
- record
- path: rtsp://10.0.19.43:554/0/av1
roles:
- detect
detect:
width: 640
height: 352
fps: 8
snapshots:
enabled: True
bounding_box: True
record:
enabled: True
retain:
days: 21
motion:
mask:
- 0,37,198,38,174,0,0,0
- 640,90,640,352,210,352
# Include all cameras by default in Birdseye view
birdseye:
enabled: True
mode: continuous
ui:
time_format: 24hour
Using ntfy, gude here.
Following this guide where emqx is setup as middle man.
docker-compose.yml
services:
frigate:
image: ghcr.io/blakeblackshear/frigate:0.13.0-beta7
container_name: frigate
hostname: frigate
restart: unless-stopped
env_file: .env
privileged: true
user: root
shm_size: "256mb"
devices:
- /dev/dri/renderD128 # for intel hwaccel, needs to be updated for your hardware
cap_add:
- CAP_PERFMON
volumes:
- /etc/localtime:/etc/localtime:ro
- ./frigate_config:/config
- /mnt/data-1/frigate_storage:/media/frigate
- type: tmpfs # 1GB of memory
target: /tmp/cache
tmpfs:
size: 1000000000
ports:
- "5000:5000" # Web GUI
- "8554:8554" # RTSP feeds
- "8555:8555/tcp" # WebRTC over tcp
- "8555:8555/udp" # WebRTC over udp
emqx:
image: emqx/emqx:5.3.2
container_name: emqx
hostname: frigate
restart: unless-stopped
env_file: .env
volumes:
- ./emqx_data:/opt/emqx/data
ports:
- 1883:1883
- 8083:8083
- 8084:8084
- 8883:8883
- 18083:18083 # Web GUI
networks:
default:
name: $DOCKER_MY_NETWORK
external: trueManual image update:
docker-compose pulldocker-compose up -ddocker image prune