Recording is the easy part of a Frigate NVR to switch on and the hard part to size. Without a plan, one of two things happens. Either retention is set to "30 days of everything" and the disk fills in a week, at which point Frigate starts deleting the oldest footage on its own; or retention is so short that the clip you needed from last Tuesday is already gone. A retention plan is a short calculation and a few numbers in config.yml . This post walks through both.
What Frigate keeps
Frigate records in short segments and keeps three kinds of footage, each with its own retention:
Continuous : all video, whether or not anything moved.
Motion : only segments in which motion was detected.
Alerts and detections : segments that overlap a review item, with a few seconds before and after ( pre_capture and post_capture , both 5 seconds by default).
Each kind has its own number of days. A segment that overlaps an alert is the one you most want to keep, so give alerts the most days.…