Для установки Frigate рекомендован Docker Compose. Камеры добавляют мастером, настраивают ускорение и детектор объектов, затем подключают интеграцию Frigate в Home Assistant через общий MQTT-брокер - сервер обмена сообщениями.
Что понадобится
До установки проверяют три вещи - камеры, MQTT-брокер и железо под детектор.
- Камеры с видео
H.264и звукомAACдают максимальную совместимость со всеми функциями Frigate и Home Assistant. Разрешение и частоту кадров настраивают на самой камере - документация Frigate советует 5 кадров в секунду для детекции почти во всех случаях и 15 для записи. Чем выше разрешение и частота кадров у потока детекции, тем выше нагрузка на процессор (CPU). - Frigate должен быть установлен и запущен до добавления интеграции. Само приложение Frigate (App, раньше такие назывались аддонами) интеграцию не заменяет.
- Детектор выбирают из поддерживаемых сервером. Несколько подпотоков (сабстримов) у камеры позволяют разделить разрешения для детекции, просмотра и записи без перекодирования.
Установка Frigate в Docker
Рекомендованный способ установки - Docker Compose. Создайте каталог, подгоните стартовый файл под свое железо и войдите в веб-интерфейс.
1. Запуск контейнера
На сервере с Linux и Docker создайте каталоги и файл Compose:
mkdir storage config && touch docker-compose.ymlВозьмите стартовый docker-compose.yml из руководства по началу работы. В нем используют образ ghcr.io/blakeblackshear/frigate:stable, подключают каталоги через ./config:/config и ./storage:/media/frigate, публикуют порты 8971:8971 и 8554:8554.
Адаптируйте файл под свое железо и запустите контейнер из этого каталога:
docker compose up -dЛогин и пароль администратора генерируются при первом запуске. Посмотрите их в логах контейнера:
docker logs frigateОткройте https://server_ip:8971 и войдите пользователем admin.
Добавление камеры
Используйте мастер Add Camera, рекомендованный в документации по настройке камер.
2. Мастер Add Camera
Откройте Settings→Global configuration→Camera management и нажмите Add Camera. Введите имя камеры, адрес и учетные данные. Probe camera получает адреса потоков по ONVIF. Manual selection подставляет шаблон по бренду камеры. Other принимает произвольный RTSP-адрес. Для камер с digest-авторизацией включите Use digest authentication. Хотя бы один поток должен иметь роль detect. Дополнительный поток добавляется кнопкой Add Another Stream. Мастер заодно настраивает go2rtc для повторной раздачи потока (restream) и привязывает живой поток.
3. Проверка и сохранение
Подключите каждый поток прямо в мастере и посмотрите живое превью и результаты валидации. Найденные проблемы потока исправляют до сохранения. Кнопка Save New Camera записывает конфигурацию камеры и сразу ее запускает, перезапуск Frigate не нужен.
Ускорение и детектор
Для декодирования видео настройте графический процессор (GPU), а для распознавания объектов выберите совместимый детектор.
4. Аппаратное ускорение
Frigate может использовать большинство встроенных GPU Intel и видеокарты Arc для ускоренного декодирования видео. Выберите пресет под ваш GPU и откройте контейнеру доступ к устройству.
| GPU Intel | Пресет |
|---|---|
| Поколения 1-7 | preset-vaapi |
| Поколения 8-12 | preset-vaapi, дополнительно доступен QSV |
| Поколения 13 и новее | пресеты preset-intel-qsv-* |
Полная таблица пресетов есть в документации по аппаратному ускорению. Смотрите логи - в них отображаются автоматическое определение, предупреждения и, при явной настройке ускорения, ошибки декодирования. Резервного режима нет - при проблемах Frigate не переключится молча на CPU, причину ищут в логах.
5. Детектор объектов
Откройте Settings > System > Detectors and model, нажмите Add и выберите тип детектора под ваше железо. Для одиночного USB Coral берите EdgeTPU с device usb. PCIe и M.2 Coral используют device pci. USB Coral не требует драйвера на сервере, а PCIe и M.2 требуют. В файле конфигурации это секция detectors, в которой атрибуту type задают значение edgetpu.
Для OpenVINO на GPU и нейропроцессоре (NPU) нужны совместимые настройки модели - Custom Model и model.path.
6. Сохранение изменений
Правки настроек не применяются, пока их не сохранили. Save фиксирует текущий раздел, Save All записывает все разделы сразу, а Review pending changes показывает затронутые области, поля и новые значения. У части настроек есть индикатор Restart required - после сохранения таких изменений нажмите Restart Frigate.
Связка с Home Assistant
Сначала вручную настройте MQTT в Home Assistant, затем добавьте интеграцию Frigate.
7. MQTT-брокер
В Settings > Devices & services нажмите Add Integration и выберите MQTT. Официальное приложение Mosquitto Broker (App, ранее - аддон) описано в документации как простой вариант. Для отдельно настроенного брокера укажите его имя хоста или IP-адрес, порт и учетные данные. Дополнительные логины для MQTT-устройств и сервисов создаются в приложении Mosquitto, а параметры уже добавленной интеграции меняются через Reconfigure. Детально настройка разобрана в гайде по MQTT и Mosquitto в Home Assistant.
8. Интеграция Frigate
На Home Assistant 2026.11 (вышла 4 ноября 2026 года) и новее HACS встроен в систему как Marketplace, и интеграцию Frigate устанавливают из Settings > Marketplace - поставить HACS отдельно на этих версиях уже нельзя. На 2026.10 и старее интеграцию ставят через HACS по пути Home Assistant > HACS > Click in the Search bar and type "Frigate" > Frigate, после чего перезапускают Home Assistant. Разницу между HACS и Marketplace подробно разбирает отдельный гайд. Если HACS не появляется в списке интеграций, у проблемы есть отдельная страница.
После установки откройте Home Assistant > Settings > Devices & Services > Add Integration > Frigate.
Включите в Frigate MQTT (enabled) и укажите тот же брокер, что и в Home Assistant, - host, user, password. От MQTT зависят многие сущности интеграции. В интеграцию передайте прямой адрес Frigate. При установке в Docker это http://<host>:5000/ на внутреннем порту без аутентификации или порт 8971 с аутентификацией. У приложения (App) адреса другие - http://ccab4aaf-frigate:5000 для стандартного варианта и http://ccab4aaf-frigate-fa:5000 для Full Access. URL прокси-приложения в качестве адреса интеграции использовать нельзя. Включите media_source для просмотра записей в Media Browser.
При настройке автоматизаций Home Assistant проверьте хост и учетные данные MQTT - ошибки в них мешают работе сущностей Frigate и автоматизаций.
Запись и хранение
Включите запись и задайте сроки хранения для непрерывного видео, движения и событий.
9. Запись и сроки хранения
Откройте Settings→Global configuration→Recording, включите Enable recording и задайте сроки. Непрерывные записи настраиваются в Continuous retention > Retention days, записи по движению - в Motion retention > Retention days. Для предупреждений о событиях (алертов) и обнаружений объектов (детекций) сроки задаются в Alert retention > Event retention > Retention days и Detection retention > Event retention > Retention days. Режим хранения задают через Alert retention > Event retention > Retention mode и Detection retention > Event retention > Retention mode, например all.
Другие способы
В Home Assistant OS Frigate можно установить приложением. Камеры можно подключить к Home Assistant и напрямую, без Frigate.
Приложение Frigate в Home Assistant OS
Откройте Settings > Apps > App Store > Repositories, добавьте https://github.com/blakeblackshear/frigate-hass-addons и установите приложение (App, ранее - аддон) - Frigate, Frigate (Full Access), Frigate Beta или Frigate Beta (Full Access). В разделе Configuration (редактор Configuration editor) настройте сеть, запустите приложение и откройте Open Web UI. Если Home Assistant у вас работает в Docker, выбирайте основной путь выше - об этой установке есть отдельный гайд.
Ручная настройка go2rtc
Для существующей камеры, которой нужна ручная настройка go2rtc, откройте Settings→System→go2rtc Streams. Нажмите Add stream, задайте потоку имя камеры для автоматической привязки, вставьте адрес потока в Source и сохраните. В конфигурации это секция go2rtc со списком streams.
RTSP restream
Frigate умеет отдавать поток камеры другим потребителям, например Home Assistant, через restream rtsp://<frigate_host>:8554/<camera_name>. Соединение с камерой общее, поток копируется без перекодирования, а порт 8554 должен быть открыт. Аннотаций Frigate в restream нет.
Generic Camera
Камеру можно подключить к Home Assistant напрямую через Generic Camera - в Settings > Devices & services нажмите Add Integration. Обязателен хотя бы один адрес - Still Image URL для снимка или Stream Source для потока. У RTSP-источника есть поля Username и Password. Если задан только поток без снимка, понадобится интеграция stream.
ONVIF
Добавьте ONVIF в Settings > Devices & services через Add Integration либо через discovery - автоматическое обнаружение.
Частые проблемы
Решения из таблицы - опыт пользователей форума, а не официальные инструкции. Число веток показывает, в скольких обсуждениях проблема встречалась.
| Проблема | Что помогало | Ветки |
|---|---|---|
| Неверный хост или учетные данные MQTT - сущности Frigate и автоматизации не работают | Заменить имя core-mosquitto на IP-адрес в конфигурации внешнего Frigate, вручную прописать IP-адрес брокера, убрать логин приложения (аддона) и использовать в frigate.yml учетные данные пользователя Home Assistant, завести для Frigate отдельную учетную запись | 4 |
Из-за устаревших компонентов или после обновлений интеграция не настраивается, управление камерами не работает - Error setting up entry 192.168.1.160:5000/ for frigate | ImportError: cannot import name 'TEMP_CELSIUS' from 'homeassistant.const' (/usr/src/homeassistant/homeassistant/const.py) | Обновить интеграцию Frigate до v5.10.0; на версиях до 2026.11 вручную установить и заново добавить HACS, обновить Frigate и перезапустить | 4 |
Неверный URL Frigate или неопубликованный порт не дает интеграции подключиться - Frigate Integration, Failed to connect message | Добавить -fa к ссылке интеграции для версии Full Access, добавить порт 5000 в docker-compose.yml и подключить интеграцию по HTTP на порту 5000, выставить внешние порты 5000 и 1935 в конфигурации приложения (аддона) и использовать адрес хоста | 3 |
| Камеры или потоки Frigate не появляются, потому что интеграция Frigate не настроена | Установить и настроить интеграцию Frigate через HACS на 2026.10 и старее, через Marketplace на 2026.11 и новее | 2 |
| Живой просмотр подтормаживает и идет рывками | Использовать go2rtc как live provider (провайдер живого просмотра), конвертировать аудио в Opus для WebRTC по руководству go2rtc | 2 |
| Frigate не может читать кадры камеры | Использовать камеру напрямую через ffmpeg, без Go2RTC | 2 |
Приложение Frigate не запускается, go2rtc занимает порт 8555 - 24-03-11 10:33:16 ERROR (SyncWorker_9) [supervisor.docker.manager] Can't start addon_ccab4aaf_frigate-fa: 500 Server Error for http+docker://localhost/v1.43/containers/e0eeee8d50addb17be8dbe7d22748284bb0448dfc4aa8526aa2016100814d678/start: Internal Server Error ("driver failed programming external c | Выключить go2rtc | 1 |
Частые вопросы
Нужен ли Coral для распознавания?
Нет, OpenVINO поддерживает графические и центральные процессоры Intel, также документированы Hailo и ONNX. CPU-детектор предназначен для тестирования, а не для постоянной работы. Смешивать разные типы детекторов, например OpenVINO и Coral, для одновременного распознавания объектов нельзя. Выбор зависит от оборудования, поддерживаемого сервером, на котором запущен Frigate.
Какие ограничения у Frigate в Home Assistant OS?
В Home Assistant OS не поддерживаются GPU AMD, NPU Intel, среда выполнения Nvidia и отдельное локальное хранилище медиа. У стандартного и бета-приложения Frigate (App, ранее - аддон) включена защита. Варианты Full Access позволяют отключить Protection mode, когда это требуется для доступа к оборудованию.
В каком виде Frigate хранит записи?
Frigate сохраняет записи прямо из потока камеры без перекодирования. Они лежат в /media/frigate/recordings, а структура каталогов использует всемирное координированное время (UTC). В консервативном примере из документации непрерывное видео хранят 3 дня, видео с движением - 7 дней, а видео, пересекающееся с алертами и детекциями, - 30 дней. Это пример сроков хранения.
Почему ONVIF не находит камеру?
При ошибке No usable cameras were found настройте хотя бы один поток H.264. Можно выделить для этого подпоток, сохранив основной поток в H.265. Совместимые профили H.264 станут сущностями в Home Assistant. Интеграция ONVIF работает с устройствами Profile S и требует заранее настроенной интеграции ffmpeg.
Почему в топиках MQTT не те имена камер?
Топики Frigate строятся из ID камеры, масок и зон, заданных в конфигурации; отображаемые имена (friendly_name) в них не участвуют. Префикс топиков по умолчанию - frigate, его меняют параметром topic_prefix. Это учитывают в автоматизациях, подписанных на топики Frigate напрямую, - подробнее в документации MQTT Frigate.
