Back to Frigate Guides

How to Fix Frigate Camera Roles Misconfigured

Frigate GuideSecurity Cameras
hard difficulty 20-30 minutes 27 views 0 found helpful Updated
This guide applies to: Frigate Frigate Camera Roles (Frigate detect/record/live role mapping)
At a glance — most common causes
  • Role-to-stream mismatch
  • Single heavy stream used for all roles
  • Incorrect ffmpeg input mapping
20-30 minutes6 solutions coveredhard level

Expert Review & Technical Scope

DeviceFrigate Frigate Camera Roles
Model CoverageFrigate detect/record/live role mapping
Fix Time20-30 minutes
DifficultyHard
Required Toolsfrigate yaml, metrics dashboard
Network / ProtocolWi-Fi / app-based troubleshooting context

Authority References

Problem Description

When your Frigate Frigate Camera Roles isn't working as expected, it usually traces back to one of a small number of causes — this guide covers them in order, starting with the most likely.

Symptoms

  • High CPU
  • No detections
  • Poor live view quality

Recognize these? Here's what usually causes it.

Common Causes

  • Role-to-stream mismatch
  • Single heavy stream used for all roles
  • Incorrect ffmpeg input mapping

Most fixes happen in the first 3 steps.

Warning

Do not optimize by guess; measure impact after each role change.

Tools & Requirements

frigate yamlmetrics dashboard

Step-by-Step Solution

1

Audit role mapping

Verify each camera input is mapped to intended Frigate role.

2

Right-size streams

Use lighter detect streams and preserve higher quality for recording.

3

Benchmark results

Measure CPU, latency, and detection accuracy after remap.

Quick Solutions

Separate streams per role
Assign proper quality per role
Retest performance and detection

Still having issues? This is usually the deeper cause below.

Camera issues that start suddenly almost always trace back to an upload bandwidth drop — run a speed test before assuming hardware failure.

Pro Tip

Role separation is the fastest path to stable Frigate performance.

Real-World Insight

Live view problems that start suddenly usually trace back to an upload speed drop — the camera itself is fine, the bandwidth path to the cloud isn't.

What Usually Goes Wrong
  • Role-to-stream mismatch
  • Single heavy stream used for all roles
  • Incorrect ffmpeg input mapping

Need More Help? Frigate Support

Note: The contact information below connects you directly to Frigate's official customer support team, not Trunetto. They can help with warranty claims, device replacements, and advanced technical issues.