Frigate 0.18: guía de migración y alternativa a DeGirum

Frigate 0.18.0 se liberó como primera versión estable el 12 de septiembre de 2026 tras varias betas, y trae 12 cambios que rompen compatibilidad respecto a la rama 0.17, según el detalle del changelog oficial. Este lanzamiento incluye 12 cambios disruptivos que los equipos deben planificar antes de actualizar de forma segura. Si administras un sistema CCTV con Frigate en una casa, una pyme o un edificio, esto no es una actualización de rutina: es una migración que puede dejarte sin snapshots legibles, sin tu detector de IA o con el stream de cámara caído si no preparas el terreno antes.

Antes de actualizar: respalda config.yml y frigate.db

El propio equipo de Frigate es categórico en este punto. En algunos casos se requerirán cambios manuales, y siempre se recomienda respaldar la configuración y la base de datos actuales antes de actualizar. El procedimiento que indica la documentación oficial es simple pero obligatorio: copiar el archivo de configuración actual a otra ubicación, y detener Frigate para hacer una copia del archivo frigate.db. La guía oficial de actualización refuerza lo mismo: hay que detener la instancia de Frigate en ejecución antes de respaldar y actualizar, y siempre respaldar el directorio /config, incluyendo config.yml y frigate.db, la base de datos SQLite. Sin este respaldo, cualquier falla del migrador automático —y las hay, como verás más abajo— puede dejarte reconfigurando cámaras desde cero.

El cambio más disruptivo: snapshots WebP sin anotar

Si tienes automatizaciones, scripts o integraciones que leen el .jpg anotado que Frigate guardaba en disco para cada evento, este es el punto que debes revisar primero. Frigate ya no guarda snapshots JPEG anotados en disco. Solo se almacena un snapshot WebP limpio y sin anotar en /media/frigate/clips/. La opción de configuración clean_copy fue eliminada, porque ahora los snapshots limpios se guardan siempre que los snapshots estén habilitados, y la calidad por defecto bajó de 70 a 60 reflejando el cambio de JPEG a WebP.

La solución oficial no es recuperar el archivo perdido, sino cambiar la fuente: quienes dependían de los .jpg anotados en disco deben usar en su lugar el endpoint /api/events/id/snapshot.jpg, que ahora admite parámetros de consulta como timestamp, bounding_box, crop, height y quality tanto para objetos en seguimiento activo como ya completados. En la práctica, si tu NVR alimenta un bot de Telegram, un dashboard de Home Assistant o un backup externo con la imagen anotada del evento, el ajuste es reemplazar la ruta de archivo por una llamada a ese endpoint con los parámetros equivalentes.

DeGirum desapareció: qué detector elegir ahora en Chile

Si tu instalación usaba un acelerador DeGirum, la mala noticia llegó sin aviso previo dentro del propio software. El detector DeGirum fue eliminado porque la empresa cesó operaciones el 1 de agosto de 2026, y la nota de la versión estable lo confirma: el detector DeGirum fue removido debido al cese de operaciones de la compañía el 1 de agosto de 2026.

Esto significa que no hay parche que lo traiga de vuelta: el soporte de fábrica desapareció junto con la empresa. Para instalaciones en Chile, lo razonable hoy es migrar a uno de los detectores que Frigate sigue manteniendo activamente: un acelerador Coral (USB o M.2) para equipos livianos de bajo consumo, una GPU Intel con OpenVINO si tu NVR corre en un mini-PC con iGPU, o una GPU NVIDIA con TensorRT si ya tienes esa tarjeta en el servidor. La elección correcta depende del hardware que ya tengas instalado y de cuántas cámaras necesitas procesar en paralelo; no hay una respuesta única, pero sí hay que descartar DeGirum de cualquier presupuesto o cotización nueva.

FFmpeg 8 y el truco en go2rtc para transcodificación acelerada

Otro salto silencioso que puede tumbar tus streams en vivo es la actualización del motor de video. FFmpeg fue actualizado a la versión 8, FFmpeg 5 queda obsoleto y se eliminará en la versión 0.19, y FFmpeg 8 introduce un problema conocido con los streams de go2rtc que transcodifican video usando aceleración por hardware: se requiere un pequeño cambio en la configuración de go2rtc.

El ajuste concreto, documentado tras las betas, es agregar el dispositivo de hardware explícito en la configuración global de go2rtc: FFmpeg 8, en todas las imágenes salvo Rockchip, rompe las transcodificaciones por hardware de go2rtc con [hwupload]; se requiere una referencia a dispositivo de hardware hasta que configures go2rtc -> ffmpeg -> global: \"-vaapi_device /dev/dri/renderD128\". Si usas cámaras con sustream transcodificado para notificaciones o para el visor en vivo y notas que el stream no carga tras actualizar, este es el primer lugar donde mirar.

Zonas, máscaras y la configuración ahora desde la interfaz

El formato de zonas y máscaras también cambió de estructura. El formato de configuración para zonas y máscaras cambió para agregar los campos enabled y friendly_name; un migrador automático hará los cambios necesarios, pero si la migración falla puede ser necesario editar las máscaras y zonas manualmente. Si después de actualizar una zona aparece deshabilitada sin motivo aparente o deja de disparar alertas, revisa que el campo enabled quedó en true y que friendly_name no quedó vacío.

El cambio de fondo, sin embargo, es de filosofía más que de sintaxis puntual: Frigate se está moviendo de un mundo centrado en YAML hacia una configuración completa desde la interfaz, y la versión 0.18 cambia ese contrato. Frigate 0.18 introduce gestión de configuración completa desde la interfaz, con un panel de Settings categorizado que cubre cada sección: cámaras, detectores, movimiento, grabación, revisión, GenAI, búsqueda semántica y más. Para quienes mantenían todo cuidadosamente versionado en YAML en un repositorio Git, esto no es necesariamente una mejora: implica que parte del estado de tu sistema ahora vive en la base de datos y se edita con clics, no con líneas de texto auditable. Si ese control de versiones te importa, puedes seguir editando config.yml directamente —Frigate sigue aceptándolo— y dejar la interfaz nueva para configuraciones puntuales.

Qué hacer esta semana si todavía no actualizas

Antes de tocar nada en producción, copia config.yml y detén el servicio para respaldar frigate.db, tal como indica la documentación oficial citada arriba. Después, revisa tres cosas en un entorno de prueba: si alguna automatización lee archivos .jpg de snapshots desde disco, si usas un detector DeGirum que debes reemplazar, y si tu stack de go2rtc transcodifica video con aceleración por hardware. Con esos tres puntos resueltos, la actualización de 0.17 a 0.18 es manejable en la mayoría de las instalaciones domésticas y de pyme. Si tu sistema es crítico —por ejemplo, el CCTV de acceso de un edificio— considera esperar a una versión 0.18.x con más correcciones acumuladas antes de tocar el servidor de producción.