Frigate 0.18, publicado el 12 de septiembre de 2026, es la versión que permite configurar el grabador de vídeo en red (NVR) entero desde su interfaz y cambiar de perfil sin reiniciar. Lo he instalado con Docker Compose, lo he actualizado desde la 0.17 con una cámara RTSP simulada y he anotado qué cambia en tu config. Esta guía sirve para una instalación nueva y para una actualización. También tienes la versión en inglés.

Puntos clave

  • Frigate 0.18.0 salió el 12 de septiembre de 2026 y, a 7 de octubre, sigue siendo la última 0.18.x, según la lista de versiones de GitHub.
  • Las notas de la versión dicen: "Frigate no longer saves annotated JPEG snapshots (.jpg) to disk." Tras actualizar, mi instalación no escribió ningún .jpg nuevo y conservó los 15 de la 0.17.
  • Pasar de 0.17 a 0.18 con Compose es cambiar la etiqueta de la imagen. Frigate copia tu config a backup_config.yaml, la migra y quitó sola sync_recordings, timelapse_args y clean_copy.
  • Un perfil que solo sigue personas dejó de crear eventos de coches al activarlo desde Ajustes, sin reiniciar: 58 coches antes y después, y de 34 a 50 personas en 100 segundos.
  • Sin GPU ni acelerador, el detector cpu funciona para probar, pero la documentación no lo recomienda para uso general.

Qué trae Frigate 0.18

Frigate 0.18 mueve la configuración al navegador y añade perfiles, un chat con un agente de IA y nuevas herramientas de revisión de vídeo. Las notas de la versión 0.18.0[1] separan los cambios que rompen compatibilidad de las novedades. La tabla recoge lo que más pesa y si lo comprobé yo.

Cambio Tipo Lo probé
Configuración completa desde Ajustes, con validación por campo Novedad Sí, vi el menú por cámara
Perfiles de configuración que se activan sin reiniciar Novedad Sí
Chat con agente de IA y más de un proveedor de GenAI con roles Novedad y migración No, no tengo un modelo conectado
Búsqueda de movimiento, repetición de depuración y casos de exportación Novedad No
Solo se guarda el snapshot limpio en WebP (<cámara>-<id>-clean.webp) Ruptura Sí
clean_copy, sync_recordings y timelapse_args eliminados Ruptura Sí, con migración automática
FFmpeg 8 y go2rtc 1.9.14 Ruptura Parcial: la imagen trae FFmpeg 8.1.1
El endpoint DELETE /api/export desaparece Ruptura No

La versión 0.18 también elimina el detector DeGirum, deprecia DeepStack y marca FFmpeg 5 para retirarlo en la 0.19. Si usas GPU con el modelo JinaV2 de búsqueda semántica, tienes que reindexar los embeddings, según las mismas notas.

Cómo instalar Frigate 0.18 con Docker Compose

Frigate 0.18 se instala con un servicio de Compose, una carpeta para la config y otra para el vídeo. Fue lo que usé, el 7 de octubre de 2026, en un Linux arm64 con Docker Engine 29.5.2 y Compose 2.40.3, sin GPU. Añade este servicio a un compose.yml en una carpeta de trabajo:

  frigate:
    image: ghcr.io/blakeblackshear/frigate:0.18.0
    restart: unless-stopped
    shm_size: "512mb"
    volumes:
      - ./config:/config
      - ./media:/media/frigate
      - type: tmpfs
        target: /tmp/cache
        tmpfs:
          size: 500000000
    ports:
      - "8971:8971"
      - "5000:5000"

El puerto 8971 es la interfaz con autenticación y el 5000 es el acceso interno sin ella, según la documentación de instalación[2]. En mi máquina compartida los remapeé a 28000 y 28001. La memoria compartida (shm_size) sale de la fórmula (ancho × alto × 1,5 × 20 + 270480) ÷ 1048576 más unos 40 MB para logs: con mi cámara de 540×960 da unos 55 MB, así que los 512 MB de arriba sobran. La imagen estándar es multiarquitectura, y las variantes -tensorrt, -rk o -rocm son para hardware concreto.

Una instalación nueva necesita una config mínima. Para reproducir esta guía, escribe la config de las secciones siguientes antes de levantar nada. Las carpetas config y media son bind mounts: conviene ponerlas en un disco con espacio, porque la carpeta de vídeo crece con cada cámara.

Cómo simular una cámara RTSP con mediamtx y ffmpeg

Para probar Frigate sin cámara, publica un vídeo en bucle por RTSP (Real-Time Streaming Protocol). Usé MediaMTX[3] v1.21.1 como servidor y el FFmpeg que ya trae la imagen de Frigate como emisor. El vídeo es un clip de 3 minutos de un paso de peatones en Anaheim (California), con licencia CC0 en Wikimedia Commons[4].

El fichero original pesa 502,7 MB y está en vertical (2160×3840). Descárgalo y recorta 50 segundos de la parte con coches y peatones, reducidos a 540×960 y 10 fotogramas por segundo:

u=https://upload.wikimedia.org/wikipedia/commons/1/13
f=3_min_pedestrian_crossing_Katella_Avenue_%28Harbor_Boulevard%29
g=_Anaheim%2C_California_July_2022.webm
curl -sSL -A "jacar-lab/1.0" -o anaheim.webm "$u/$f$g"
docker run --rm -v "$PWD":/w \
  --entrypoint /usr/lib/ffmpeg/7.0/bin/ffmpeg \
  ghcr.io/blakeblackshear/frigate:0.18.0 \
  -v error -y -ss 130 -t 50 -i /w/anaheim.webm -an \
  -vf scale=540:960,fps=10 -c:v libx264 -preset veryfast \
  -crf 24 -g 20 -pix_fmt yuv420p /w/clip.mp4

El resultado, clip.mp4, ocupa 7,3 MB. Añade ahora los dos servicios que lo emiten, encima del de Frigate, en el mismo compose.yml:

name: b8p20
services:
  mediamtx:
    image: bluenviron/mediamtx:latest
    restart: unless-stopped
  publisher:
    image: ghcr.io/blakeblackshear/frigate:0.18.0
    entrypoint: ["/usr/lib/ffmpeg/7.0/bin/ffmpeg"]
    command: >
      -nostats -loglevel error -re -stream_loop -1
      -i /clip.mp4 -c copy -f rtsp -rtsp_transport tcp
      rtsp://mediamtx:8554/patio
    volumes:
      - ./clip.mp4:/clip.mp4:ro
    depends_on: [mediamtx]
    restart: unless-stopped
  # el servicio frigate de arriba va aquí

-re lee el fichero a velocidad real, -stream_loop -1 lo repite sin fin y -c copy evita recodificarlo. MediaMTX acepta por defecto un emisor sin autenticación en el puerto 8554, así que la cámara simulada queda en rtsp://mediamtx:8554/patio dentro de la red de Compose. El nombre b8p20 es el prefijo de mi laboratorio; usa el que prefieras.

Cómo añadir la cámara y activar la detección con la CPU

Frigate lee la cámara, graba y detecta con una config de unas 40 líneas. Esta es la que usé tras migrarla, guardada como config/config.yml:

mqtt:
  enabled: false
detectors:
  cpu1:
    type: cpu
    num_threads: 3
ui:
  timezone: Europe/Madrid
record:
  enabled: true
  alerts:
    retain:
      days: 2
  detections:
    retain:
      days: 2
snapshots:
  enabled: true
  quality: 70
objects:
  track: [person, car]

El detector cpu evita necesitar un acelerador. En la guía de detectores de objetos[5] se lee: "The CPU detector is not recommended for general use." Frigate lo repite en el log con el aviso CPU detectors are not recommended and should only be used for testing or for trial purposes. Para una cámara real conviene un Coral, un detector OpenVINO en Intel o una GPU.

La segunda mitad de la config define la cámara y una zona. La zona calzada cubre del 45 % al 100 % de la altura de la imagen:

cameras:
  patio:
    ffmpeg:
      inputs:
        - path: rtsp://mediamtx:8554/patio
          roles: [detect, record]
    detect:
      enabled: true
      width: 540
      height: 960
      fps: 5
    zones:
      calzada:
        coordinates: 0,0.45,1,0.45,1,1,0,1
version: 0.18-0

Los roles detect y record usan la misma entrada, de modo que Frigate abre un único flujo. Para una cámara con dos flujos, el principal para grabar y el secundario para detectar, ahorras CPU. Arranca todo con docker compose up -d.

Primer arranque y acceso a la interfaz

Con la autenticación activada, Frigate crea el usuario admin en el primer arranque y escribe la contraseña en el log una sola vez. Léela con:

docker compose up -d
docker compose logs frigate | grep -A4 "Created a default user"

Entra en https://localhost:8971 con ese usuario (el certificado es autofirmado, así que el navegador avisará). Cambia la contraseña desde Ajustes, en Users. El puerto 5000 no pide credenciales: no lo publiques fuera de tu máquina ni detrás de un proxy inverso. En mi prueba, sin límites, Frigate usó unos 736 MiB de RAM; si quieres acotarlo, tienes los límites de recursos y logs en Compose.

Revisar eventos, grabaciones y snapshots

En cuanto la cámara simulada emite, Frigate empieza a crear eventos. En la pestaña Explore aparecen los objetos rastreados con su miniatura, y en Review, las alertas agrupadas por momento. Frigate agrupa en Review las personas y los coches detectados, y anota en cada evento las zonas que pisan, como calzada.

Fotograma de la cámara de prueba con un recuadro azul sobre una persona etiquetada person 74% que cruza una calle, generado por Frigate 0.18.0 desde el snapshot limpio.

Esa imagen sale de la API: /api/events/<id>/snapshot.jpg?bbox=1 dibuja el recuadro sobre el snapshot limpio, que es lo que cambia en la 0.18. El mismo evento ofrece el clip con /api/events/<id>/clip.mp4, que me devolvió un MP4 de 2,8 MB, y el snapshot sin anotar en snapshot-clean.webp, de 47 KB. Tras unos 8 minutos de prueba, media/recordings ocupaba 50 MB y media/clips, 6,4 MB.

Qué cambia al actualizar de la 0.17 a la 0.18

Actualizar es parar el contenedor, copiar la config y la base de datos, y cambiar la etiqueta de la imagen. Empecé con Frigate 0.17.0 y la config de la sección anterior, pero con las opciones antiguas. Cuando acumuló 15 eventos, hice la copia y subí de versión:

docker compose stop frigate
mkdir -p backup && cp config/config.yml config/frigate.db backup/
sed -i 's/frigate:0.17.0/frigate:0.18.0/' compose.yml
docker compose up -d frigate

La copia sigue la recomendación de las notas de la versión. El log mostró Migrating frigate config from 0.17-0 to 0.18-0... y Making backup of DB before migrations..., y Frigate dejó backup_config.yaml y backup.db en /config. El backup_config.yaml era idéntico a mi config de la 0.17. Esto es lo que quitó la migración, en formato diff:

   enabled: true
-  sync_recordings: false
-  export:
-    timelapse_args: "-vf setpts=0.04*PTS -r 30"
   alerts:
...
   enabled: true
-  clean_copy: true
   quality: 70
...
-version: 0.17-0
+version: 0.18-0

Tres hallazgos más de esta migración:

  1. ui.date_format ya fallaba en la 0.17.0. La primera vez que la incluí, Frigate 0.17.0 registró Config Validation Errors con Extra inputs are not permitted, y mi cámara no generó eventos hasta quitarla y reiniciar.
  2. ui.time_format siguió funcionando en la 0.18.0, a pesar de que las notas lo dan por eliminado. La API devolvió time_format: 24hour sin error. No te fíes de ello: bórralo cuando puedas.
  3. No hubo cambio en las zonas. Mi zona con coordenadas en una cadena de texto cargó sin editarla y la API la devolvió con el campo enabled: true. Las notas avisan de una migración automática y de que puede hacer falta editar a mano si falla.

Del lado del disco, el cambio de snapshots se nota al contar ficheros: tras la actualización, media/clips tenía 15 .jpg (todos de la 0.17) y ninguno nuevo, y 104 -clean.webp. La imagen de 0.18.0 ocupa 6,57 GB en disco (1,56 GB de contenido). La 0.17.0 ocupa 6,21 GB (1,45 GB). La nueva añade FFmpeg 8.1.1 junto a las versiones 5 y 7.

Perfiles: cambiar la detección sin reiniciar

Un perfil es un conjunto con nombre de cambios sobre la config de cada cámara, y se activa sin reiniciar. Las notas lo describen así: "Profiles let you define named overrides on top of your base camera configuration and switch between them on the fly". Definí uno, solo_personas, que reduce lo que rastrea la cámara a personas:

profiles:
  solo_personas:
    friendly_name: Solo personas

cameras:
  patio:
    profiles:
      solo_personas:
        objects:
          track:
            - person

Añadí los dos bloques a la config y reinicié Frigate una vez para que los cargara. Después activé el perfil en Ajustes, Global configuration, Profiles, sin tocar el contenedor. La API de configuración pasó a devolver track: ['person'] para la cámara y /api/profile/active respondió solo_personas.

Ajustes de Frigate 0.18.0, sección Profiles, con el perfil Solo personas activado y el aviso verde de que se ha activado, sin reiniciar el contenedor.

Para comprobar el efecto conté los eventos antes y 100 segundos después. Los coches se quedaron en 58 y las personas subieron de 34 a 50. Un perfil sirve para alternar entre "en casa" y "fuera" sin editar el YAML. Según las notas, el perfil activo se guarda por MQTT (Message Queuing Telemetry Transport) en frigate/profile/set, así que una automatización de Home Assistant con Docker puede cambiarlo.

Lo que no he probado

No probé el chat con el agente, los proveedores de GenAI, los embeddings remotos, la búsqueda de movimiento ni los casos de exportación. Exigen un modelo de lenguaje (LLM) conectado o vídeo real acumulado. Tampoco medí la velocidad de inferencia: la máquina estaba compartida, con una carga media por encima de 30, así que cualquier cifra de milisegundos no valdría. En un servidor propio sin GPU, mira el indicador de latencia del detector en la página de estadísticas del sistema.

Si conectas la integración con Home Assistant, la documentación[6] exige tener MQTT configurado en los dos lados antes, y se instala a través de HACS (Home Assistant Community Store). Si ambos comparten red de Compose, la URL de conexión es http://frigate:8971.

Preguntas frecuentes

¿Puedo probar Frigate sin una cámara real?

Sí: MediaMTX recibe un vídeo en bucle por RTSP y Frigate lo trata como una cámara. En mi prueba detectó coches y personas de un clip de dominio público, y generó clips, snapshots y grabaciones como con un equipo real.

¿Qué hago con mi config de la 0.17 al actualizar?

Haz copia de config.yml y de frigate.db, cambia la etiqueta a 0.18.0 y arranca. Frigate migra la config y guarda backup_config.yaml. Después revisa el log: si ves Config Validation Errors, quita las claves que señala.

¿Necesito un acelerador para usar Frigate 0.18?

No para probarlo, pero sí para uso real. El detector cpu arranca sin hardware y la documentación avisa de que no se recomienda para uso general. Con una o más cámaras reales conviene un Coral, OpenVINO o una GPU.

Conclusión

Frigate 0.18 se instala con un servicio de Compose. Se actualiza desde la 0.17 cambiando la etiqueta, porque la migración de la config y de la base de datos es automática y deja copia. Lo que más cambia en el día a día son la configuración desde el navegador, los perfiles sin reinicio y el snapshot limpio en WebP en lugar del JPEG anotado.

Antes de actualizar, copia config.yml y frigate.db y revisa si tu config usa las opciones eliminadas. Con la cámara simulada puedes ensayarlo todo sin tocar la instalación que vigila de verdad.

Fuentes: [1] Notas de la versión Frigate 0.18.0[1], [2] Instalación de Frigate[2], [3] Detectores de objetos de Frigate[5], [4] Integración de Frigate con Home Assistant[6], [5] MediaMTX en GitHub[3], [6] Vídeo CC0 en Wikimedia Commons[4].

Fuentes

  1. notas de la versión 0.18.0
  2. documentación de instalación
  3. MediaMTX
  4. Wikimedia Commons
  5. detectores de objetos
  6. documentación