Frigate is a Docker container that can be run on any Docker host including as a HassOS Addon. See instructions below for installing the HassOS addon.
For Home Assistant users, there is also a custom component (aka integration). This custom component adds tighter integration with Home Assistant by automatically setting up camera entities, sensors, media browser for clips and recordings, and a public API to simplify notifications.
Note that HassOS Addons and custom components are different things. If you are already running Frigate with Docker directly, you do not need the Addon since the Addon would run another instance of Frigate.
HassOS users can install via the addon repository. Frigate requires an MQTT server.
- Navigate to Supervisor > Add-on Store > Repositories
- Add https://github.com/blakeblackshear/frigate-hass-addons
- Setup your network configuration in the
Configurationtab if deisred
- Create the file
configdirectory with your detailed Frigate configuration
- Start the addon container
- If you are using hardware acceleration for ffmpeg, you will need to disable "Protection mode"
Make sure you choose the right image for your architecture:
It is recommended to run with docker-compose:
If you can't use docker compose, you can run the container with something similar to this:
The default shm-size of 64m is fine for setups with 3 or less 1080p cameras. If frigate is exiting with "Bus error" messages, it could be because you have too many high resolution cameras and you need to specify a higher shm size.
You can calculate the necessary shm-size for each camera with the following formula:
The shm size cannot be set per container for Home Assistant Addons. You must set
/etc/docker/daemon.json to increase the default shm size. This will increase the shm size for all of your docker containers. This may or may not cause issues with your setup. https://docs.docker.com/engine/reference/commandline/dockerd/#daemon-configuration-file
Use the helm chart.
For ideal performance, Frigate needs access to underlying hardware for the Coral and GPU devices for ffmpeg decoding. Running Frigate in a VM on top of Proxmox, ESXi, Virtualbox, etc. is not recommended. The virtualization layer typically introduces a sizable amount of overhead for communication with Coral devices.
Some people have had success running Frigate in LXC directly with the following config:
For details on running Frigate under ESX, see details here.