Profiles

Profiles allow you to define named sets of camera configuration overrides that can be activated and deactivated at runtime without restarting Frigate. This is useful for scenarios like switching between "Home" and "Away" modes, daytime and nighttime configurations, or any situation where you want to quickly change how multiple cameras behave.

How Profiles Work

Profiles operate as a two-level system:

1. Profile definitions are declared at the top level of your config under profiles. Each definition has a machine name (the key) and a friendly_name for display in the UI.
2. Camera profile overrides are declared under each camera's profiles section, keyed by the profile name. Only the settings you want to change need to be specified — everything else is inherited from the camera's base configuration.

When a profile is activated, Frigate merges each camera's profile overrides on top of its base config. When the profile is deactivated, all cameras revert to their original settings. Only one profile can be active at a time.

info

Profile changes are applied in-memory and take effect immediately — no restart is required. The active profile is persisted across Frigate restarts (stored in the /config/.profiles file).

Configuration

The easiest way to define profiles is to use the Frigate UI. Profiles can also be configured manually in your configuration file.

Creating and Managing Profiles

Frigate UI

1. Create a profile — Navigate to Settings→Camera configuration→Profiles. Click the Add Profile button, enter a name (and optionally a profile ID).
2. Configure overrides — Navigate to a camera configuration section (e.g. Motion detection, Record, Notifications). In the top right, two buttons will appear - choose a camera and a profile from the profile selector to edit overrides for that camera and section. Only the fields you change will be stored as overrides — fields that require a restart are hidden since profiles are applied at runtime. You can click the Remove Profile Override button to clear overrides.
3. Activate a profile — Use the Profiles option in Frigate's main menu to choose a profile. Alternatively, in Settings, navigate to Settings→Camera configuration→Profiles, then choose a profile in the Active Profile dropdown to activate it. The active profile is also shown in the status bar at the bottom of the screen on desktop browsers.
4. Delete a profile — Navigate to Settings→Camera configuration→Profiles, then click the trash icon for a profile. This removes the profile definition and all camera overrides associated with it.

YAML

First, define your profiles at the top level of your Frigate config. Every profile name referenced by a camera must be defined here.

profiles:
  home:
    friendly_name: Home
  away:
    friendly_name: Away
  night:
    friendly_name: Night Mode

Under each camera, add a profiles section with overrides for each profile. You only need to include the settings you want to change.

cameras:
  front_door:
    ffmpeg:
      inputs:
        - path: rtsp://camera:554/stream
          roles:
            - detect
            - record
    detect:
      enabled: true
    record:
      enabled: true
    profiles:
      away:
        detect:
          enabled: true
        notifications:
          enabled: true
        objects:
          track:
            - person
            - car
            - package
        review:
          alerts:
            labels:
              - person
              - car
              - package
      home:
        detect:
          enabled: true
        notifications:
          enabled: false
        objects:
          track:
            - person

Supported Override Sections

The following camera configuration sections can be overridden in a profile:

Section	Description
enabled	Enable or disable the camera entirely
audio	Audio detection settings
birdseye	Birdseye view settings
detect	Object detection settings
face_recognition	Face recognition settings
lpr	License plate recognition settings
motion	Motion detection settings
notifications	Notification settings
objects	Object tracking and filter settings
record	Recording settings
review	Review alert and detection settings
snapshots	Snapshot settings
zones	Zone definitions (merged with base zones)

note

Only the fields you explicitly set in a profile override are applied. All other fields retain their base configuration values. For masks and zones, profile zones override the camera's base masks and zones. If configuring profiles via YAML, you should not define masks or zones in profiles that are not defined in the base config.

Activating Profiles

Profiles can be activated and deactivated from the Frigate UI. Open the Settings cog and select Profiles from the submenu to see all defined profiles. From there you can activate any profile or deactivate the current one. The active profile is indicated in the UI so you always know which profile is in effect.

Example: Home / Away Setup

A common use case is having different detection and notification settings based on whether you are home or away. This example below is for a system with two cameras, front_door and indoor_cam.

Frigate UI

1. Navigate to Settings→Camera configuration→Profiles and create two profiles: Home and Away.
2. From to the Camera configuration section in Settings, choose the front_door camera, and select the Away profile from the profile dropdown. Then, enable notifications from the Notifications pane, and set alert labels to person and car from the Review pane. Then, from the profile dropdown choose Home profile, then navigate to Notifications to disable notifications.
3. For the indoor_cam camera, perform similar steps - configure the Away profile to enable the camera, detection, and recording. Configure the Home profile to disable the camera entirely for privacy.
4. Activate the desired profile from Settings→Camera configuration→Profiles or from the Profiles option in Frigate's main menu.

YAML

profiles:
  home:
    friendly_name: Home
  away:
    friendly_name: Away

cameras:
  front_door:
    ffmpeg:
      inputs:
        - path: rtsp://camera:554/stream
          roles:
            - detect
            - record
    detect:
      enabled: true
    record:
      enabled: true
    notifications:
      enabled: false
    profiles:
      away:
        notifications:
          enabled: true
        review:
          alerts:
            labels:
              - person
              - car
      home:
        notifications:
          enabled: false

  indoor_cam:
    ffmpeg:
      inputs:
        - path: rtsp://camera:554/indoor
          roles:
            - detect
            - record
    detect:
      enabled: false
    record:
      enabled: false
    profiles:
      away:
        enabled: true
        detect:
          enabled: true
        record:
          enabled: true
      home:
        enabled: false

In this example:

• Away profile: The front door camera enables notifications and tracks specific alert labels. The indoor camera is fully enabled with detection and recording.
• Home profile: The front door camera disables notifications. The indoor camera is completely disabled for privacy.
• No profile active: All cameras use their base configuration values.