How to Connect Frigate to Home Assistant with MQTT (Step-by-Step)

Frigate + MQTT: connect Frigate to Home Assistant, step by step

Use this at your own risk, and test it before relying on it, especially anything that controls a real device. Full disclaimer

Updated 8 November 2026

Frigate spots people, cars and animals on your cameras. Home Assistant can turn that into phone alerts, lights that come on, and camera views on your dashboard. The thing that joins them is MQTT: a small message service that Frigate uses to tell Home Assistant what it has seen.

This guide connects Frigate to Home Assistant with MQTT in five short steps. It takes about 15 minutes. I tested every step in a sandbox, with a fresh Mosquitto, Frigate 0.18 and Home Assistant, and the Frigate integration v5.15.6.

On this page (11 sections)

See how it works

Press Someone walks up and follow the message from the camera to your phone. Then untick MQTT or the Frigate integration and try again, or turn detection off from Home Assistant. Under the demo is the generator you’ll use in Step 1.


Open the generator full screen

What you need to connect Frigate to Home Assistant

  • Home Assistant, any kind. If you haven’t got it yet, follow my Home Assistant with Docker Compose guide.
  • Frigate already running with at least one camera. You can open its web page and see the camera.
  • Marketplace in Home Assistant, to install the Frigate integration. It’s built in from 2026.11 at Settings → Marketplace. On older versions it’s called HACS, which needs setting up first.
Tip: on Home Assistant OS, the easiest broker is the official Mosquitto broker add-on. Pick Mosquitto add-on in the generator and it gives you those steps instead.

Step 1: Set up the MQTT broker (Mosquitto)

The broker is the post office in the middle. Frigate posts messages to it, and Home Assistant collects them. In the generator, pick Mosquitto in Docker and fill in your server’s IP address. Then, on the server where Frigate runs:

  1. Make a folder and go into it:
    mkdir -p ~/mosquitto && cd ~/mosquitto
  2. Save compose.yaml from the generator there, and mosquitto.conf into the settings folder the Commands tab makes.
  3. Run the Commands. They make two logins, one for Frigate and one for Home Assistant (you type each password twice), then start Mosquitto.

The generator’s settings turn anonymous logins off, so only Frigate and Home Assistant can connect. I checked this in the sandbox: the right username and password connects, and a connection with no login or the wrong password gets not authorised.

Step 2: Point Frigate at the broker

  1. Open the generator’s Frigate config tab and copy the mqtt: block.
  2. Paste it at the top of Frigate’s config.yml (or in Frigate’s web page: Settings → Configuration editor). Put Frigate’s password in place of the-password-you-set-for-frigate.
  3. Restart Frigate.

To check it worked, look at Mosquitto’s log. Within a minute you should see Frigate log in:

docker compose logs mosquitto | grep frigate
# New client connected from 172.18.0.3 as frigate (... u'frigate').

Step 3: Add MQTT to Home Assistant

  1. In Home Assistant, go to Settings → Devices & services → Add integration and search for MQTT.
  2. Broker: your server’s IP. Port: 1883. Username and Password: the Home Assistant login from Step 1. Leave the rest as it is.
  3. Click Submit. MQTT now appears in your integrations.
Do this step before Step 5. The Frigate integration happily connects without MQTT, but then Home Assistant gets no sensors or switches at all, and no error tells you why. In my sandbox it showed 0 Frigate entities until MQTT was added.

Step 4: Install the Frigate integration

  1. Open Settings → Marketplace (HACS before 2026.11), search for Frigate and open it (it’s by Blake Blackshear).
  2. Click Install, then Install again (Download in HACS).
  3. Restart Home Assistant: Settings → System, the power icon at the top right → Restart Home Assistant.

Step 5: Connect Home Assistant to Frigate

  1. Go to Settings → Devices & services → Add integration and search for Frigate.
  2. URL: http://YOUR-SERVER-IP:5000. Use port 5000 (Frigate’s API), not 8971 (its login page). If Frigate is the Home Assistant OS add-on, the dialog tells you the address to use instead.
  3. Click Submit.
Home Assistant Add integration dialog for Frigate with the URL http://192.168.1.10:5000
The Frigate dialog. It also says Home Assistant needs ports 5000, 8554 and 8555.

Each camera now appears as a device, with a camera, motion and person sensors, object counts, and switches for detection, recordings and snapshots.

Home Assistant device page for a Frigate camera called Front Door, with sensors and Detect, Motion and Recordings switches
One camera from my sandbox (a test pattern, not a real camera). The Activity list shows Detect being switched off and on from Home Assistant.

Check it works

  • From Home Assistant to Frigate: on a camera’s device page, switch Detect off. Frigate’s log says Turning off detection for front_door. Switch it back on.
  • From Frigate to Home Assistant: walk in front of a camera. Its Person occupancy sensor changes to Detected, then clears when you leave.
  • See the messages themselves: Settings → Devices & services → MQTT → Configure, then under Listen to a topic type frigate/# and click Start listening.
Home Assistant integrations page showing MQTT and Frigate with 3 devices
MQTT and Frigate side by side in Settings → Devices & services.

Next: put all your cameras on one page with the free Frigate Timeline Card, and drag back in time across every camera at once.

If something’s wrong

  • Frigate is connected, but Home Assistant has no Frigate sensors or switches. MQTT isn’t set up in Home Assistant (Step 3). Add it, then go to Frigate → ⋮ → Reload.
  • Mosquitto’s log says “not authorised”. A username or password is wrong. Check the user and password in Frigate’s mqtt: block, and the login in Home Assistant’s MQTT settings.
  • “Failed to connect” when adding Frigate. Home Assistant can’t reach port 5000. Open http://YOUR-SERVER-IP:5000/api/version from the Home Assistant machine. It should show Frigate’s version.
  • Camera pictures load, but live video doesn’t. Home Assistant also needs Frigate’s ports 8554 and 8555 for live video.
  • Two Frigates on one broker. Give the second one its own topic_prefix in its mqtt: block, so their messages don’t mix.
Using a reverse proxy in front of Home Assistant? If Home Assistant answers 400 Bad Request through the proxy but works by IP, it doesn’t trust the proxy. On Home Assistant 2026.9 and newer, the trusted_proxies setting in configuration.yaml can be silently ignored: turn on Trust X-Forwarded-For and add your proxy under Trusted proxies in Settings → System → Network instead.
Keep it on your home network. Frigate’s port 5000 has no login, and MQTT carries everything your cameras see. Don’t forward ports 1883 or 5000 on your router, or put them on a public tunnel. To watch from outside, use Home Assistant’s own remote access.

Updating

  • Mosquitto: cd ~/mosquitto && docker compose pull && docker compose up -d
  • The Frigate integration: Marketplace shows an update when there’s a new one. Update it, then restart Home Assistant.

Frequently asked questions

Why do I need MQTT for Frigate and Home Assistant?

MQTT is the message service Frigate uses to tell Home Assistant what it has seen. Without it, the Frigate integration has no sensors or switches.

Why does Mosquitto say "not authorised"?

A username or password is wrong. Check the user in Frigate's mqtt: block and the login in Home Assistant's MQTT settings.

Why do camera pictures load but live video doesn't?

Home Assistant also needs Frigate's ports 8554 and 8555 for live video, not just 5000.

Can I open Frigate's ports to watch from outside?

Don't. Port 5000 has no login and MQTT carries everything your cameras see. Use Home Assistant's own remote access instead.

Thank you

Frigate and its Home Assistant integration are made by Blake Blackshear and the Frigate team, and Mosquitto by the Eclipse Foundation. All free and open source.

Related guides: Home Assistant with Docker Compose · Frigate Timeline Card · Home Assistant wall tablet

If this guide helped you, consider buying me a coffee. It helps keep guides like this one coming.

☕Buy me a coffee

Get new guides by email

About one email a month: new step-by-step guides and card releases. No spam, unsubscribe any time.

I'll send a confirmation email first. See the privacy policy.

Leave a Reply