administrator/frigate
1
0
Fork 0
mirror of https://github.com/blakeblackshear/frigate.git synced 2026-05-01 19:17:41 +03:00
Code Issues Actions 2 Packages Projects Releases Wiki Activity
18c068a3f9
frigate/docs/docs/configuration/notifications.md
Josh Hawkins 18c068a3f9
Add network requirements docs (#22874) 
* Add network requirements docs

* shorten title

* add note about network requirements in each section
2026-04-14 08:03:34 -06:00

3.7 KiB
Raw Blame History

id title
notifications Notifications

import ConfigTabs from "@site/src/components/ConfigTabs"; import TabItem from "@theme/TabItem"; import NavPath from "@site/src/components/NavPath";

Notifications

Frigate offers native notifications using the WebPush Protocol which uses the VAPID spec to deliver notifications to web apps using encryption.

:::info

Push notifications require internet access from the Frigate server to the browser vendor's push service (e.g., Google FCM, Mozilla autopush). See Network Requirements for details.

:::

Setting up Notifications

In order to use notifications the following requirements must be met:

  • Frigate must be accessed via a secure https connection (see the authorization docs).
  • A supported browser must be used. Currently Chrome, Firefox, and Safari are known to be supported.
  • In order for notifications to be usable externally, Frigate must be accessible externally.
  • For iOS devices, some users have also indicated that the Notifications switch needs to be enabled in iOS Settings --> Apps --> Safari --> Advanced --> Features.

Configuration

Enable notifications and fill out the required fields.

Optionally, change the default cooldown period for notifications. The cooldown can also be overridden at the camera level.

Notifications will be prevented if either:

  • The global cooldown period hasn't elapsed since any camera's last notification
  • The camera-specific cooldown period hasn't elapsed for the specific camera

Global notifications

  1. Navigate to .
    • Set Email to your email address
    • Enable notifications for the desired cameras
notifications:
  enabled: True
  email: "johndoe@gmail.com"
  cooldown: 10 # wait 10 seconds before sending another notification from any camera

Per-camera notifications

  1. Navigate to and select the desired camera.
    • Set Enable notifications to on
    • Set Cooldown period to the desired number of seconds to wait before sending another notification from this camera (e.g. 30)
cameras:
  doorbell:
    ...
    notifications:
      enabled: True
      cooldown: 30 # wait 30 seconds before sending another notification from the doorbell camera

Registration

Once notifications are enabled, press the Register for Notifications button on all devices that you would like to receive notifications on. This will register the background worker. After this Frigate must be restarted and then notifications will begin to be sent.

Supported Notifications

Currently notifications are only supported for review alerts. More notifications will be supported in the future.

:::note

Currently, only Chrome supports images in notifications. Safari and Firefox will only show a title and message in the notification.

:::

Reduce Notification Latency

Different platforms handle notifications differently, some settings changes may be required to get optimal notification delivery.

Android

Most Android phones have battery optimization settings. To get reliable Notification delivery the browser (Chrome, Firefox) should have battery optimizations disabled. If Frigate is running as a PWA then the Frigate app should have battery optimizations disabled as well.