Web UI flashes briefly, then just black

[MrSurly]

After restarting the container (ghcr.io/blakeblackshear/frigate:stable), everything seems to come up okay, but any attempt to access the webui flashes the ui very briefly, then goes black.

I've cleared caches, tried incognito, tried different browsers, etc. I've searched the issues and discussions. Nothing.

This is simply from bringing down the docker stack, pulling, and restarting.

I've tried older docker images in the 0.17 line, but they're all the same.

I've verified my config.yml is valid per yamllint

I do get this JS console error in the browser:

Uncaught TypeError: M.config is undefined
    p6 http://garage.local:5000/assets/index-CmkyCNGk.js:74
    p6 http://garage.local:5000/assets/index-CmkyCNGk.js:74
    Jl http://garage.local:5000/assets/index-CmkyCNGk.js:40
    Jo http://garage.local:5000/assets/index-CmkyCNGk.js:40
    Rh http://garage.local:5000/assets/index-CmkyCNGk.js:40
    oi http://garage.local:5000/assets/index-CmkyCNGk.js:38
    x0 http://garage.local:5000/assets/index-CmkyCNGk.js:40
    Xi http://garage.local:5000/assets/index-CmkyCNGk.js:40
    Rc http://garage.local:5000/assets/index-CmkyCNGk.js:40
    D http://garage.local:5000/assets/index-CmkyCNGk.js:25
    vt http://garage.local:5000/assets/index-CmkyCNGk.js:25
    eL http://garage.local:5000/assets/index-CmkyCNGk.js:25
    eL http://garage.local:5000/assets/index-CmkyCNGk.js:25
    B4 http://garage.local:5000/assets/index-CmkyCNGk.js:25
    rL http://garage.local:5000/assets/index-CmkyCNGk.js:33
    dp http://garage.local:5000/assets/index-CmkyCNGk.js:40
    nL http://garage.local:5000/assets/index-CmkyCNGk.js:40
    <anonymous> http://garage.local:5000/assets/index-CmkyCNGk.js:40
index-CmkyCNGk.js:74:11880

Docker logs:

frigate  | s6-rc: info: service s6rc-fdholder: starting
frigate  | s6-rc: info: service s6rc-oneshot-runner: starting
frigate  | s6-rc: info: service s6rc-oneshot-runner successfully started
frigate  | s6-rc: info: service fix-attrs: starting
frigate  | s6-rc: info: service s6rc-fdholder successfully started
frigate  | s6-rc: info: service fix-attrs successfully started
frigate  | s6-rc: info: service legacy-cont-init: starting
frigate  | s6-rc: info: service legacy-cont-init successfully started
frigate  | s6-rc: info: service prepare: starting
frigate  | s6-rc: info: service log-prepare: starting
frigate  | s6-rc: info: service log-prepare successfully started
frigate  | s6-rc: info: service nginx-log: starting
frigate  | s6-rc: info: service go2rtc-log: starting
frigate  | s6-rc: info: service frigate-log: starting
frigate  | s6-rc: info: service certsync-log: starting
frigate  | s6-rc: info: service go2rtc-log successfully started
frigate  | s6-rc: info: service frigate-log successfully started
frigate  | s6-rc: info: service certsync-log successfully started
frigate  | s6-rc: info: service nginx-log successfully started
frigate  | s6-rc: info: service prepare successfully started
frigate  | s6-rc: info: service go2rtc: starting
frigate  | s6-rc: info: service go2rtc successfully started
frigate  | s6-rc: info: service go2rtc-healthcheck: starting
frigate  | s6-rc: info: service frigate: starting
frigate  | s6-rc: info: service go2rtc-healthcheck successfully started
frigate  | s6-rc: info: service frigate successfully started
frigate  | s6-rc: info: service nginx: starting
frigate  | 2026-03-27 22:21:12.310837000  [INFO] Starting NGINX...
frigate  | 2026-03-27 22:21:12.333688438  [INFO] No TLS certificate found. Generating a self signed certificate...
frigate  | 2026-03-27 22:21:12.525528987  [INFO] Preparing Frigate...
frigate  | 2026-03-27 22:21:12.685549777  [INFO] Preparing new go2rtc config...
frigate  | 2026-03-27 22:21:12.804545296  [INFO] Starting Frigate...
frigate  | 2026-03-27 22:21:12.997447078  [INFO] Starting go2rtc...
frigate  | 2026-03-27 22:21:13.354853297  22:21:13.354 INF go2rtc platform=linux/amd64 revision=df95ce3 version=1.9.10
frigate  | 2026-03-27 22:21:13.354856927  22:21:13.354 INF config path=/config/go2rtc_homekit.yml
frigate  | 2026-03-27 22:21:13.356076442  22:21:13.355 INF [rtsp] listen addr=:8554
frigate  | 2026-03-27 22:21:13.356079468  22:21:13.355 INF [webrtc] listen addr=:8555
frigate  | 2026-03-27 22:21:13.356197995  22:21:13.356 INF [api] listen addr=:1984
frigate  | s6-rc: info: service nginx successfully started
frigate  | s6-rc: info: service certsync: starting
frigate  | s6-rc: info: service certsync successfully started
frigate  | s6-rc: info: service legacy-services: starting
frigate  | 2026-03-27 22:21:15.218844572  [INFO] Starting certsync...
frigate  | s6-rc: info: service legacy-services successfully started
frigate  | 2026-03-27 22:21:15.565939615  127.0.0.1 - - [27/Mar/2026:22:21:15 -0700] "" 400 0 "-" "-" "-" request_time="0.000" upstream_response_time="-"
frigate  | 2026-03-27 22:21:16.221302337  [2026-03-27 22:21:16] frigate.util.config            INFO    : Checking if frigate config needs migration...
frigate  | 2026-03-27 22:21:16.235613410  [2026-03-27 22:21:16] frigate.util.config            INFO    : frigate config does not need migration...
frigate  | 2026-03-27 22:21:16.372029294  [2026-03-27 22:21:16] frigate.util.services          INFO    : Automatically detected vaapi hwaccel for video decoding
frigate  | 2026-03-27 22:21:16.384610080  [2026-03-27 22:21:16] frigate.app                    INFO    : Starting Frigate (0.17.1-416a9b7)
frigate  | 2026-03-27 22:21:16.404261359  [2026-03-27 22:21:16] peewee_migrate.logs            INFO    : Starting migrations
frigate  | 2026-03-27 22:21:16.404941048  [2026-03-27 22:21:16] peewee_migrate.logs            INFO    : There is nothing to migrate
frigate  | 2026-03-27 22:21:16.418934412  [2026-03-27 22:21:16] frigate.app                    INFO    : Recording process started: 624
frigate  | 2026-03-27 22:21:16.433306555  [2026-03-27 22:21:16] frigate.app                    INFO    : Review process started: 637
frigate  | 2026-03-27 22:21:16.435122257  [2026-03-27 22:21:16] frigate.app                    INFO    : go2rtc process pid: 115
frigate  | 2026-03-27 22:21:16.618885521  [2026-03-27 22:21:16] frigate.app                    INFO    : Embedding process started: 647
frigate  | 2026-03-27 22:21:16.636854722  INFO: Created TensorFlow Lite XNNPACK delegate for CPU.
frigate  | 2026-03-27 22:21:16.637732824  [2026-03-27 22:21:16] frigate.detectors              WARNING : CPU detectors are not recommended and should only be used for testing or for trial purposes.
frigate  | 2026-03-27 22:21:16.653662846  [2026-03-27 22:21:16] frigate.app                    INFO    : Output process started: 700
frigate  | 2026-03-27 22:21:16.665908197  Exception in thread camera_processor:
frigate  | 2026-03-27 22:21:16.665912487  Traceback (most recent call last):
frigate  | 2026-03-27 22:21:16.665924506    File "/usr/lib/python3.11/threading.py", line 1038, in _bootstrap_inner
frigate  | 2026-03-27 22:21:16.666078878      self.run()
frigate  | 2026-03-27 22:21:16.666134274    File "/opt/frigate/frigate/camera/maintainer.py", line 193, in run
frigate  | 2026-03-27 22:21:16.666182094      self.__start_camera_processor(camera, config)
frigate  | 2026-03-27 22:21:16.666207035    File "/opt/frigate/frigate/camera/maintainer.py", line 137, in __start_camera_processor
frigate  | 2026-03-27 22:21:16.666240128      self.region_grids[name],
frigate  | 2026-03-27 22:21:16.666280539      ~~~~~~~~~~~~~~~~~^^^^^^
frigate  | 2026-03-27 22:21:16.666293426  KeyError: 'garage_ext'
frigate  | 2026-03-27 22:21:16.858224229  [2026-03-27 22:21:16] frigate.api.fastapi_app        INFO    : Starting FastAPI app
frigate  | 2026-03-27 22:21:16.966739065  [2026-03-27 22:21:16] frigate.api.fastapi_app        INFO    : FastAPI started
frigate  | 2026-03-27 22:21:22.310222943  [INFO] Starting go2rtc healthcheck service...
frigate  | 2026-03-27 22:21:27.971905030  10.1.0.100 - - [27/Mar/2026:22:21:27 -0700] "GET / HTTP/1.1" 200 2655 "-" "Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:148.0) Gecko/20100101 Firefox/148.0" "-" request_time="0.001" upstream_response_time="-"
frigate  | 2026-03-27 22:21:28.532715270  10.1.0.100 - - [27/Mar/2026:22:21:28 -0700] "GET /api/config HTTP/1.1" 200 29885 "http://garage.local:5000/" "Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:148.0) Gecko/20100101 Firefox/148.0" "-" request_time="0.006" upstream_response_time="0.003"
frigate  | 2026-03-27 22:21:28.532919429  10.1.0.100 - - [27/Mar/2026:22:21:28 -0700] "GET /api/profile HTTP/1.1" 200 86 "http://garage.local:5000/" "Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:148.0) Gecko/20100101 Firefox/148.0" "-" request_time="0.007" upstream_response_time="0.003"
frigate  | 2026-03-27 22:21:28.541001676  10.1.0.100 - - [27/Mar/2026:22:21:28 -0700] "GET /api/profile HTTP/1.1" 200 86 "http://garage.local:5000/" "Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:148.0) Gecko/20100101 Firefox/148.0" "-" request_time="0.001" upstream_response_time="0.001"
frigate  | 2026-03-27 22:21:28.790266667  10.1.0.100 - - [27/Mar/2026:22:21:28 -0700] "GET /ws HTTP/1.1" 101 985 "-" "Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:148.0) Gecko/20100101 Firefox/148.0" "-" request_time="0.238" upstream_response_time="0.236"
frigate  | 2026-03-27 22:21:28.799629412  10.1.0.100 - - [27/Mar/2026:22:21:28 -0700] "GET /api/review?limit=10&severity=alert&reviewed=0 HTTP/1.1" 200 4643 "http://garage.local:5000/" "Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:148.0) Gecko/20100101 Firefox/148.0" "-" request_time="0.012" upstream_response_time="0.010"
frigate  | 2026-03-27 22:22:15.623125832  127.0.0.1 - - [27/Mar/2026:22:22:15 -0700] "" 400 0 "-" "-" "-" request_time="0.000" upstream_response_time="-"
frigate  | 2026-03-27 22:23:15.678084847  127.0.0.1 - - [27/Mar/2026:22:23:15 -0700] "" 400 0 "-" "-" "-" request_time="0.000" upstream_response_time="-"
frigate  | 2026-03-27 22:24:15.732719387  127.0.0.1 - - [27/Mar/2026:22:24:15 -0700] "" 400 0 "-" "-" "-" request_time="0.000" upstream_response_time="-"
frigate  | 2026-03-27 22:25:15.785636142  127.0.0.1 - - [27/Mar/2026:22:25:15 -0700] "" 400 0 "-" "-" "-" request_time="0.000" upstream_response_time="-"

[inkeep-ai-assistant[bot]]

The black screen issue is caused by a configuration error visible in your Docker logs. The critical error is:

KeyError: 'garage_ext'

(1)

This indicates that a camera named garage_ext is referenced somewhere in your configuration but is not properly defined in the cameras section. The camera_processor thread crashes because it cannot find the region grid for this camera, which prevents the UI from loading properly.

To resolve this:

1. Check your config.yml for any references to garage_ext and ensure the camera is fully defined in the cameras section with all required fields.
   (1)

2. You can validate your configuration before restarting using the API:

curl -X POST http://frigate_host:5000/api/config/save -d @config.json

(1)

Or via command line:

docker run \
  -v $(pwd)/config.yml:/config/config.yml \
  --entrypoint python3 \
  ghcr.io/blakeblackshear/frigate:stable \
  -u -m frigate \
  --validate-config

(1)

Note that yamllint only validates YAML syntax, not Frigate's schema requirements. The Frigate validation methods above will catch configuration issues like missing camera definitions.
(1)

📚 Sources:

1. Advanced Options

---

Have another question? Just tag @inkeep.

[MrSurly]

epoulsen@garage:~$ docker run \
  -v $(pwd)/config.yml:/config/config.yml \
  --entrypoint python3 \
  ghcr.io/blakeblackshear/frigate:stable \
  -u -m frigate \
  --validate-config^C
epoulsen@garage:~$ cd /var/lib/frigate/config/
epoulsen@garage:/var/lib/frigate/config$ docker run \
  -v $(pwd)/config.yml:/config/config.yml \
  --entrypoint python3 \
  ghcr.io/blakeblackshear/frigate:stable \
  -u -m frigate \
  --validate-config
[2026-03-28 05:32:03] frigate.util.config            INFO    : Checking if frigate config needs migration...
[2026-03-28 05:32:03] frigate.util.config            INFO    : frigate config does not need migration...
[2026-03-28 05:32:03] frigate.util.services          WARNING : Did not detect hwaccel, using a GPU for accelerated video decoding is highly recommended
*************************************************************
*** Your config file is valid.                            ***
*************************************************************