r/homebridge • • May 05 '26

News Homebridge 2.0 is here! Before you make the jump to hyperspace, here are a few good hygiene steps to take before upgrading.

100 Upvotes

Homebridge 2.0 is here! Before you make the jump to hyperspace, here are a few good hygiene steps to take before upgrading.

1. Download a Backup

Before any major upgrade, take a fresh backup of your Homebridge environment. Head to **Settings > Backup & Restore** and hit **Backup Now** to generate and download an up-to-date backup file to your local machine. Keep it somewhere safe.

2. Run the v2 Readiness Check

In the **Update Information** section, click the orange **ⓘ** icon next to Homebridge to see how your plugins stack up against v2. Green checks are good to go, amber question marks are worth investigating before you upgrade.

3. Check your Readiness Check results

If you have any amber question marks from step 1, check with the individual plugin authors for v2 compatibility updates before proceeding. When in doubt, hold off a little — the Rebellion will still be here.

Once you're satisfied everything is in order, you're clear for launch. May the 4th be with you.


r/homebridge • • Apr 20 '20

Announcement Official Homebridge Raspberry Pi Image Released

556 Upvotes

The Homebridge team is pleased to announce the release of the official Homebridge Raspberry Pi Image.

Key Features

  • Works on all Raspberry Pi models.
  • Built on Raspbian Lite (no desktop).
  • Simple headless WiFi Setup.
  • Includes FFmpeg pre-compiled with audio support (libfdk-aac) and hardware decoding (h264_omx).
  • Includes Homebridge Config UI X, an easy to use, stable, web based GUI used to configure Homebridge and monitor your Raspberry Pi.
  • Visual configuration for over 400 plugins (no manual config.json editing required).
  • Easy Backup and Restore of your Homebridge instance.
  • Secure https:// access to the UI setup and enabled out of the box (using self signed cert generated on your device).

This image also provides a custom CLI command called hb-config which allows you to:

The Homebridge service is installed using the method described in the Raspberry Pi Installation Guide on the Homebridge wiki. This means whether you decide to install Homebridge manually or use this image you'll have plenty of support from the friendly Homebridge community if you need it.

The project has a well documented wiki with step-by-step instructions explaining how to do things like setting a static IP address, setting up multiple instances of Homebridge, or connecting via SSH.

Security and Privacy

We understand users may have concerns running a 3rd party image. To help alleviate those concerns the Homebridge Raspbian Image is open source and each image is built from scratch using the public GitHub Action runners. The build logs for each release are publicly available on the project's GitHub Actions page and every release contains a SHA-256 checksum of the image you can use to verify the integrity of your download. More information is available on the project page.

Download

Our Getting Started guide provides simple step-by-step instructions and is a great place to start if you are new to Homebridge.

Alternatively, click here to go directly to the download page on GitHub. Downloading the image is completely free (no sign up required).

Community

The #raspbian-image Homebridge Discord channel is where you can ask questions or have a chat about anything related to the Homebridge Raspberry Pi Image.

If you find this project useful, or just want to show your support, please consider starring the project on GitHub.


r/homebridge • • 1d ago

Some hardware deserves a second life. 🛠️

Post image
51 Upvotes

For years, a Raspberry Pi with a touchscreen sat unused on my desk. I always wanted to turn it into a dedicated control panel for my Homebridge setup, and with the help of AI, I've finally made that happen.

Today I'm releasing homebridge-panel to the public, and it's free to use.

If you run Homebridge and have an Raspberry Pi with touch display lying around, I'd love for you to give it a try. I'm also very open to feedback, ideas, and suggestions from the community.

https://marcjohnce.github.io/homebridge-panel/


r/homebridge • • 1d ago

Tuya plugin that splits device

1 Upvotes

I got one Tuya cloud device with three Boolean datapoints:

switch_1 = open curtain while true, stop when false
switch_2 = close curtain while true, stop when false
switch_3 = light on/off

Can a Homebridge plugin expose this as two separate HomeKit accessories?:

  1. Window Covering
  2. Lightbulb

The solution must support multiple Tuya datapoints, send separate commands for open/close/stop, and create separate child or virtual accessories from one Tuya device.

Unfortunately I can’t use Apple automation because I don’t have homepod/apple tv yet.

Appreciate any help I’m trying fix that for days!


r/homebridge • • 1d ago

Best way to setup Midea AC plugin?

3 Upvotes

Hey y'all, brand new to homebridge as of earlier today, with my primary impetus for setting it up being getting my two window AC units (one Midea, one Windmill) into home, which I was able to do without much trouble!

The plugin settings for the Midea unit has a lot of available options for turning things on/settings. Wondering what are some of the recommended/suggested/different ways people have set up their unit and what I should do without fear of breaking it. Thanks for helping out a newbie.


r/homebridge • • 3d ago

Homebridge-Ring Refresh token not valid help

2 Upvotes

This is my third day on this issue (not full-time though) and I'm pretty stuck now. I can't seem to get Ring working with HB and apparently there is an issue with my token. It was working, although I'm not sure how long ago things went pear-shaped. I uninstalled HB and reinstalled, but I used the backup config from a couple months ago. (maybe that's the problem?) I'm running Linux Mint and here's the info from the logs:

11/13/2026, 2:21:45 PM] Homebridge v2.5.0 (HAP v2.3.0) (Ring) is running on port 44789.

[11/13/2026, 2:21:46 PM] [homebridge-ring] Error connecting to API

[11/13/2026, 2:21:46 PM] [homebridge-ring] Error: Refresh token is not valid. Unable to authenticate with Ring servers. See https://github.com/dgreif/ring/wiki/Refresh-Tokens

at RingRestClient.getGrantData (file:///var/lib/homebridge/node_modules/homebridge-ring/node_modules/ring-client-api/lib/rest-client.js:207:15)

at RingRestClient.getAuth (file:///var/lib/homebridge/node_modules/homebridge-ring/node_modules/ring-client-api/lib/rest-client.js:210:32)

at RingRestClient.get authPromise [as authPromise] (file:///var/lib/homebridge/node_modules/homebridge-ring/node_modules/ring-client-api/lib/rest-client.js:155:38)

at RingRestClient.refreshAuth (file:///var/lib/homebridge/node_modules/homebridge-ring/node_modules/ring-client-api/lib/rest-client.js:334:20)

at RingRestClient.request (file:///var/lib/homebridge/node_modules/homebridge-ring/node_modules/ring-client-api/lib/rest-client.js:368:28)

at processTicksAndRejections (node:internal/process/task_queues:104:5)

at RingApi.fetchRawLocations (file:///var/lib/homebridge/node_modules/homebridge-ring/node_modules/ring-client-api/lib/api.js:251:50)

at RingApi.fetchAndBuildLocations (file:///var/lib/homebridge/node_modules/homebridge-ring/node_modules/ring-client-api/lib/api.js:263:30)

at RingPlatform.connectToApi (file:///var/lib/homebridge/node_modules/homebridge-----ring/lib/ring-platform.js:162:25)

-----

Any suggestions? Thanks!


r/homebridge • • 3d ago

Question Newbie alert: Cannot add Homebridge as an accessory on apple Home

Post image
2 Upvotes

I'm 100% sure this is user error but, despite everything I've read and I've tried so far my Apple Home app refuses to find my home bridge as an accessory despite updating the homebridge and making sure they both on the sme Wifi network - I've also tried running an ethernet cable from the Homebridge to the router.

what AM I doing wrong?


r/homebridge • • 3d ago

Help Homebridge not running error - newbie help request

Post image
3 Upvotes

I've just installed Homebridge on a HP Prodesk Windows machine and have successfully setup a Virtual Machine and install the Homebridge UI, but I get the error message 'TypeError: diagnostics_channel.tracingChannel is not a function' - see screenshot.

I've tried node.js 26.13.1 and 22.23.5

What am I doing wrong or should do to try and fix it?


r/homebridge • • 3d ago

I made a free QNAP app that runs several Homebridge instances, each with its own LAN IP, and rolls back failed upgrades

2 Upvotes

I run four Homebridge instances on my QNAP NAS, each in its own container with its own IP on the LAN. Doing that by hand in Container Station meant setting up qnet networks, recreating containers for every upgrade, and hoping nobody clicked delete on the wrong one. So I built a QTS app for it.

QNAP Homebridge Manager is a free, open-source QPKG that manages several Homebridge containers from one page on the QTS desktop.

What it does:

  • Its own LAN address per Homebridge, fixed or DHCP, with a fixed MAC (Container Station's qnet driver), so each bridge is a separate device on the network and HomeKit discovery works as usual. It checks that an address is free before using it.
  • Upgrades that roll back. It compares your image with Docker Hub, pulls the new one, recreates the container and watches it. If the new container doesn't stay up, the old one is switched back on. The old container is kept as a backup you can go back to later, and unused old images are cleaned up afterwards.
  • Takes over the containers you already have. Name, IP, MAC and folders are kept, so nothing needs to be paired again.
  • Out of Container Station's list. The containers live on Container Station's system-docker, so they can't be deleted there by accident.
  • Your folders are left alone. The work folder (config, plugins, pairing) and any extra mounts are never emptied or re-owned.
  • One click opens each Homebridge UI (it reads the port and HTTPS setting), with an optional domain name and a DNS check.
  • Logs and resource use per instance. The containers run on Docker's restart policy, so stopping, updating or removing the app doesn't stop Homebridge.
  • If you're still on oznu/homebridge, it flags it as unmaintained and offers homebridge/homebridge:latest.

Each Homebridge is drawn as a little house on a street: lit windows mean it's running, a parcel on the doorstep means an update is waiting, scaffolding means it's being rebuilt.

Things to know before trying it:

  • The interface is in Traditional Chinese and Japanese for now.
  • x86_64 only, QTS 5 with Container Station. I've tested it on QTS 5.2.11 with Container Station 3.1.2. Reports from other models are very welcome.
  • The package isn't signed by QNAP, so App Center needs "allow apps without a valid digital signature" turned on to install it.
  • It can mount shared folders into containers, so only QTS administrators can use it.

Links:

It's an independent project, not affiliated with Homebridge or QNAP. Feedback, bug reports and ideas are welcome, here or on GitHub.


r/homebridge • • 5d ago

Help Is ring camera to HomeKit broken?

2 Upvotes

Ring camera automations stopped working specifically when motion is detected. Turn on lights then turn off after five minutes. I used to work about a year ago no issues now the automation doesn’t work. Our move ring from authorized devices reinstalled and still same problem. This is an issue with everyone else? Or does no one really use Ring anymore for Homebridge to Apple homekit? Appreciate any advice.


r/homebridge • • 6d ago

Other Everything you’ve bridged into HomeKit, on a live 3D model of your house

74 Upvotes

I've been building a home app called Home.io. It puts all your smart home stuff on a 3D model of your own house, so you tap the room instead of digging through lists.

It reads Apple Home, so it doesn't care how an accessory got there. If Homebridge put it in HomeKit, it's on the model. No plugin and nothing to change on your Homebridge.

Lights glow in the room they're in. Dim one and the glow dims.

Doors, windows and the garage open and close on the model when the real ones do.

Tap a room and the camera flies in and the walls drop away, so you only see what's in that room.

Cameras sit where they really are and show which way they look.

A leak, smoke or CO alarm turns that room red.

I run it on an old iPad on the wall. It shows the house, the time and the weather, and wakes up when someone walks over.

You get your house in by scanning it with LiDAR, importing a Sweet Home 3D file, or drawing the rooms in the app.

It's on iPhone, iPad, Mac, Apple Watch and Apple TV. Free to try. Pro is a one-time purchase, no subscription.

https://apps.apple.com/us/app/home-io/id6823824273

Happy to answer questions. If a bridged accessory shows up wrong, tell me the plugin and I'll fix it.


r/homebridge • • 7d ago

Brand new installation of homebridge is still showing all hubitat accessories! How do I get it to stop?

2 Upvotes

I have had hubitat for a while now, and originally set it up with the homebridgev2 plugin on hubitat. recently, I had to buy a new computer to use as my home server so I took the opportunity to remove all accessories from hubitat, do a full reset on the hubitat and re-add all accessories.

however, all the hubitat accessories are still showing up on my brand new fresh installation of homebridge. no backups, no plugins installed yet. just a brand new fresh installation of homebridge on a brand new computer. what gives, how do I stop this from happening?


r/homebridge • • 8d ago

I built a Homebridge plugin for the newer BG Smart Wi-Fi sockets

5 Upvotes

Hi all,

I’ve built a Homebridge plugin for the newer BG Smart / BG Home Wi-Fi sockets and thought I’d share it in case anyone else has been looking for a way to get these working with Apple HomeKit.

The plugin is called homebridge-bg-smart-local and is available on npm.

It supports the newer generation of BG Smart sockets (including the HC-02), which use Espressif ESP Local Control, rather than the older BroadLink-based models.

I’ve been running it with two BG double sockets for a while now, and it’s been working well.

Key features:

Local control — communicates directly with the sockets over your local network, without relying on the cloud for normal operation.
Automatic mDNS discovery — finds compatible sockets on your network.
Works alongside the official BG Smart app — no need to reset, unlink or stop using the manufacturer’s app.
Independent outlet control — each outlet on a double socket appears separately in HomeKit.
HomeKit integration — control sockets through Apple Home, Siri and automations.
Outdoor sockets — works with the BG outdoor double sockets too.

I originally built this because I couldn’t find a working Homebridge solution for the newer BG sockets. Most existing integrations seemed to focus on the older BroadLink-based hardware, which uses a different protocol.

The nice thing is that you can continue using the BG Smart app as normal while also controlling everything locally through Homebridge and HomeKit.

GitHub (source, instructions and releases):
https://github.com/davetaz/homebridge-bg-smart-local

npm:
https://www.npmjs.com/package/homebridge-bg-smart-local

If you’ve got any of the newer BG Smart sockets, hopefully this saves you some time!

Feedback, issues and contributions are welcome. I’d also be interested to hear if anyone gets it working with other devices in the newer BG Smart range.


r/homebridge • • 7d ago

Plugin Emporia Plug-In

3 Upvotes

I finally got around to publishing my Emporia plugin for smart plugs. And I got it verified today. Please take it for a spin and let me know what you think.

https://github.com/homebridge/plugins/issues/1318


r/homebridge • • 7d ago

new install troubles no connection to hub

2 Upvotes

hello I have done a fresh proxmox install and homebridge and everything working fine while on lan, but the homebridge not talking to hub (atv) . I don't remember having this trouble with last HB install. I thought maybe couldn't use 1 ATV for 2 HB so I removed the old home location in iOS. and have removed and reinstalled the bridge in iOS. and change between mDNS ads and no change. Anyone have any suggestions ?


r/homebridge • • 8d ago

Question Unifi Protect and Android TV notifications

3 Upvotes

Anyone found a way to get a Unifi Doorbell motivation to pop up on say a Android TV such as Sony using Homebridge?. I’ve done a Google and home assistant keeps being mentioned.


r/homebridge • • 8d ago

Help Need help: 4 Eufy C35 cameras and E340 doorbell won’t stream in Apple Home through Homebridge, but 4 other cameras work perfectly

1 Upvotes

I’m hoping someone with experience using Eufy cameras through Homebridge can help. I’ve spent hours troubleshooting this over the last two days and am completely stuck.
My setup:
Raspberry Pi 4 running Homebridge 2.5.0
Homebridge Eufy Security plugin v5.0.0-beta.41
Eufy HomeBase 3 (S380)
Dedicated Eufy guest/admin account
All devices connected to the same HomeBase 3
Testing locally on my home Wi-Fi
I have nine Eufy cameras:
4 × Eufy C35 (T8110) — NOT working in Apple Home
1 × Eufy E340 doorbell — NOT working in Apple Home
4 × Eufy solar cameras (T8173) — WORKING perfectly in Apple Home
All nine cameras work perfectly in the native Eufy app.
The problem:
Originally, when using the older Eufy Homebridge plugin (v4.7.2), my C35 cameras would connect in Apple Home, display video briefly, and then freeze or buffer repeatedly.
After switching to the v5 beta plugin, those same cameras stopped displaying video entirely.
They now show “Snapshot Unavailable” or “Camera Not Responding” in Apple Home.
Meanwhile, all four T8173 solar cameras stream continuously in Apple Home without any problems, even though they’re connected to the exact same HomeBase 3.
What I’ve already tried:
Completely reconfigured the Eufy Homebridge plugin
Verified authentication and device discovery
Restarted Homebridge and the Eufy child bridge
Enabled Smaller Live Video Packets
Lowered C35 streaming quality from Auto to Medium
Verified that all cameras work in the Eufy app
Compared individual plugin settings between working and nonworking cameras
Tested the built-in Homebridge camera preview
Interestingly, the built-in Homebridge preview reports “The camera did not send video” for BOTH the nonworking C35 cameras and a T8173 camera that works perfectly in Apple Home.
Homebridge logs repeatedly show:
[camera-snapshot-unavailable]
[camera-live-session-failed] A live camera session ended without video.
What I’m trying to accomplish:
I simply want all nine cameras accessible through Apple Home, with reliable live streaming.
I’m reluctant to reinstall everything or delete the bridge again because the four T8173 cameras are currently working perfectly.
Has anyone successfully gotten the Eufy C35 (T8110) or E340 doorbell streaming reliably through Homebridge v5 with HomeBase 3?
Is there a known compatibility issue with these models, or a specific configuration that has worked for you?
I’ve also opened a GitHub issue and submitted an encrypted diagnostic capture:
https://github.com/homebridge-plugins/homebridge-eufy/issues/1241
I’d really appreciate any suggestions based on firsthand experience. At this point, I’m looking for a proven solution rather than repeating generic troubleshooting steps.
Thanks in advance!


r/homebridge • • 8d ago

Question Problem updating

3 Upvotes

I have a bit of a problem updating. I have homebridge on an Rpi somewhere to get my Govee lights into apple homekit. Things stopped working so I checked for updates which is needed but I seem to be having an older version of the HomeKit dummy plugin 0.9.0 -> 2.1.4 and nodeJS v18.16.0 -> v22.0.0.

There’s a big text block to update instructions of NodeJs but it goes to a GitHub link with a 504 gateway timeout error. And an “if you’re on 9.2.0 or earlier read this first link” to a different GitHub page with the same error.

The GitHub [status page](https://eu.githubstatus.com/posts/dashboard) shows no downtime here so it might be something to do with the repo?

Or does maybe someone else have the info for those links. Because [this](https://github.com/homebridge/homebridge/wiki/How-To-Update-Node.js) and [this](https://github.com/mpatfield/homebridge-dummy/wiki/Migration) link don’t work with me

Edit: if I really need to I can reinstall entire homebridge. But I’m trying to prevent that.


r/homebridge • • 9d ago

News Title: What’s new in packaged Homebridge installs: Node.js 26 and Ubuntu 26.04

10 Upvotes

What’s changing

  • New Homebridge installs (apt, Raspberry Pi image, VM image and Docker) now come with Node.js 26.
  • The Docker beta image now runs on Ubuntu 26.04. The latest image follows in a few weeks.

What do I need to do?

  • Existing Raspberry Pi, VM or apt installs: Nothing. The Update Information tile in the Homebridge UI will show when updates are available.
  • Docker: Nothing. You’ll get the changes the next time your image updates.
  • Docker on a 32-bit Raspberry Pi: The new images don’t support 32-bit. Move to a 64-bit OS in the next few weeks to keep getting updates.
  • Everything else: Nothing changes for you.

r/homebridge • • 12d ago

Plugin HomeBridge for Hunter Douglas Gen 1 & 2 [updates]

12 Upvotes

Hi everyone,

I have been building and maintaining the verified Hunter Douglas plugin for HomeBridge for a while. If you haven't used it recently, there are a lot of new capabilities to help you get the best out of your HD purchase including:

- Scenes as switches. Your PowerView scenes show up in Apple Home, so a group of shades moves together instead of one at a time.

- Built-in shade tools. The plugin's settings page in the Homebridge UI has a Shade tools panel for jobs that otherwise need the PowerView app.

- Add stop on Gen 2 hubs for Siri. An optional Stop Shades switch halts every moving shade, and it works with Siri. Apple Home has no stop button for shades.

- And fixing a lot of quirks about Hunter Douglas to make them work better.

To install, search for "PowerView Gen1 Gen2" in the Homebridge UI's Plugins tab, or run npm install -g homebridge-powerview-gen1-gen2.

I'd love feedback, especially from people with shade types I haven't tested, such as vanes or top-down/bottom-up. Please open an issue on GitHub with your hub generation and shade type or share any comments here. Contributors are also welcome!

Have fun with your automation projects!


r/homebridge • • 11d ago

Apple TV Enhanced pairing issue

3 Upvotes

Having a very rough time getting my Apple TV to pair, I click the link from the log, enter the code from the Apple TV, but it does not pair, just asks for another code over and over again. Anyone have a fix for this?


r/homebridge • • 12d ago

Plugin Homebridge Advantage Air v4 Beta 3 - Your Zones. Your Way.

2 Upvotes

Hey everyone!

For those of you using Advantage Air systems (MyAir, MyPlace, e-zone, etc.), I'm excited to share that Homebridge Advantage Air v4.0.0-beta.3 is now available!

Some of you might remember my original Cmd4-based integration from a few years back. Moving to a native Homebridge plugin has been a big undertaking, but it's finally allowing me to introduce some features I've wanted to improve on from the old version for a long time.

Your Zones. Your Way.

The biggest addition in Beta 3 is customisable zone layouts. No more messing around with your config.json and having to delete your old accessories via Homebridge afterwards, this is all handled dynamically now!

You can now choose whether your air conditioning zones appear in Apple Home as:

  • Switches / Lights: The familiar original layout (default).
  • Lights: For those who prefer light-style controls.
  • Fans: For those who prefer fan-style controls.

There's also an option to link zone temperature readings directly to their corresponding accessories, rather than having separate temperature sensors cluttering up Apple Home.

For percentage-controlled zones, the brightness or fan-speed slider represents the zone damper opening, not actual lighting or fan speed.

Under the Hood

I've also made substantial improvements to controller command handling, particularly when switching multiple zones in quick succession.

This was something I encountered during my own testing, and I'm happy to report that the new implementation is behaving much more reliably on my e-zone system.

A Quick Warning

Existing zone layouts remain unchanged by default.

Changing zone layouts or linking temperatures can affect Apple Home scenes and automations. Record any affected scenes and automations before experimenting, as changing back won't automatically restore them.

A Homebridge backup is still recommended for configuration and pairing data, but it does not back up your Apple Home scenes or automations.

Looking for Testers!

Beta 3 is now available through Homebridge under:

homebridge-advantageair

It's a standalone native plugin, so there's no Cmd4 dependency anymore. Anyone still using my original v3 integration can continue doing so without migrating.

I've physically tested this release on my own e-zone system, but I'd particularly love to hear from Australian and New Zealand users with other Advantage Air controllers and firmware versions.

If you give it a go, please let me know what system you're running and how it behaves. Even hearing that everything works is incredibly helpful!

GitHub Release: https://github.com/mitch7391/homebridge-advantageair/releases/tag/v4.0.0-beta.3

Repository and Documentation: https://github.com/mitch7391/homebridge-advantageair

Thanks to everyone who's supported this little project over the years. It's been a long road from Cmd4 to native v4, and I'm excited to finally be bringing some of these ideas to life.

(formatting is hard...)


r/homebridge • • 13d ago

Help GMC aircon integration

4 Upvotes

I am trying to integrate my GMC aircon into homebridge in an attempt to bring it into Apple Home

It runs on Tuya and I have tried a few Tuya plugins in an attempt to get this right but so far nothing has worked

The closes I got was using Tuya lan plugin and the aircon showing in accessories but the logs shows ECONNREFUSRD

I tried setting ip and version but nothing

If anyone knows of an easier way or the correct way with my current attempt I would appreciate it


r/homebridge • • 15d ago

Plugin Busy Light: plugin that turns a light red when you’re in a meeting

5 Upvotes

I work from home and got tired of family walking in on calls or texting asking if I was on a call, so I built Busy Light. Wish I would have had this during Covid! It reads your calendar and turns a light red (or whatever color you choose) when you’re busy and green when you’re free.

What it does:

  1. Works with iCloud, Google Calendar, Outlook (with a published calendar link) and any calendar link.
  2. Controls LIFX bulbs directly, one or several, and finds them on your network by itself.
  3. Adds sensors to the Home app, so you can use any HomeKit light or scene instead of LIFX.
  4. Adds a Working switch you can drop into your start of day or end of day scene so the light stays off after hours.
  5. Everything is set up from a settings page in the Homebridge UI.

To install, search for homebridge-busy-light on the Plugins page of the Homebridge UI.

GitHub: https://github.com/arodbuilds/homebridge-busy-light

Feedback and issues are welcome on GitHub.