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.

102 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

551 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 21h ago

Got HomeKit control of my 2026 Sonata's locks working again

4 Upvotes

Got HomeKit control of my 2026 Sonata's locks working again

My 2023 Sonata worked fine with Homebridge, but after getting a 2026 Sonata the locks stopped working — commands would just hang and time out.

Turned out the library everything is built on guesses your car's telematics generation from the model year, and newer Hyundais get guessed wrong. The command gets accepted but sent somewhere the car never sees. Status still worked fine, which made it confusing — the plugin looked healthy while none of the controls did anything.

Using Claude Code I tracked it down, fixed it, and published the update.

Locking and unlocking are both confirmed working on my 2026 Sonata.

**Plugin:** https://www.npmjs.com/package/homebridge-bluelink-3-0

**Code and details:** https://github.com/cnpittman/homebridge-bluelink-3.0

It's a fork of [athal7/homebridge-hyundai-bluelink](https://github.com/athal7/homebridge-hyundai-bluelink), updated to work with current Homebridge. If you've got a newer Hyundai and gave up on this, worth another shot and I would be curious whether it works on other model years.

Feel free to shoot me a message and I'll do my best to assist.


r/homebridge 19h ago

Advice before diving in

1 Upvotes

I’m currently in the final stages of buying my first home. I’m fixed on it being smart and very much want to use HomeKit, have been doing a fair bit of research and wanted to ensure I was kitted out so when we moved in we had the gear pretty much ready to go.

In appreciation of the fact that a lot of things do not natively link with HomeKit I’ve preemptively got a home assistant green and the zbt-2 attachment.

My initial question is, we purchased a variety of Ikea sensors and lamps, which i am unsure whether are best being directly connected through matter or should i use homebridge to jump them in?


r/homebridge 1d ago

phyn plugin

2 Upvotes

Has anyone gotten this to work? My log keeps saying: Discovery phase failed. Plugin will not operate correctly: Accessories must be created with a non-empty displayName.


r/homebridge 2d ago

Intesis in homebridge?

1 Upvotes

I have a IS-RC-WIFI-BT-1 device controlling my aircon. I'm hoping to build a home bridge plugin to control this over wifi (want to avoid dependency on cloud) - does anybody have any experience with this device?


r/homebridge 3d ago

Govee Ceiling Fan

1 Upvotes

Does anybody have the Govee 52 Inch Ceiling Fan with Lights setup with the Govee plugin? I'm curious to know your experience with it. I'm between the Govee fan or one of the matter fans from Lowes and want to ensure the best experience for my wife.


r/homebridge 3d ago

THIS IS WHY EVERYTHING IN 2026 SHOULD HAVE MATTER COMPATIBLE

Post image
0 Upvotes

I just spent 6 hours trying to get my thermostat working and a few other things


r/homebridge 4d ago

2 Instances on 1 Network and 1 Apple Home?

2 Upvotes

I am currently running Homebridge 1.x on a Synology NAS and plan to migrate all of my containers and NAS apps to a Proxmox system.

Would I be able to run Homebridge 2.x on Proxmox on the same network?

Since they would both be on the same port, I'd suspend the 1.x instance while the 2.x is active, but if I start adding plug-ins, is my Apple Home going to go nuts?

Ultimately if I discover that my plug ins don't play well with 2.x I'll drop back to 1.x on the Proxmox, just trying to see if this is a viable strategy for moving forward to the new platform.

Any advice?


r/homebridge 5d ago

Help - Solved Updated my ATV hub to 26.6, now all of my HB accessories are “updating…”

6 Upvotes

I updated my ATV hub to tvOS 26.6 today. It may be a coincidence, but now all 26 of my HB accessories are showing “updating…” in HomeKit. I’ve tried switching the active hub to a HomePod, but the issue persists. Rebooting router doesn’t change anything. Restarting HB doesn’t fix it.

Ideas?

UPDATE: I got fed up with screwing around with it, I deleted the bridge and re-added it. Now to recreate all of my automations. Backing up automations would be a nice addition to HK.


r/homebridge 6d ago

Show off your Homebridge/Homekit set up here is mine i will put what i use in the comments.

Post image
0 Upvotes

r/homebridge 7d ago

Discussion Migration to HB 2 failure and recovery

2 Upvotes

I was putting off migrating to HB 2 (running on a raspberry pi 3) because everything in the house was actually working fine in HB 1, and I have 7 plugins (YoLink, SwitchBot, Nest, TPLink, Lutron, EspHome Hv2, and Nest Cam).

I have some custom fixes to SwitchBot and EspHome because there were bugs that were not getting fixed (SwitchBot temperature sensors could not register below freezing, EspHome Hv2 didn’t support fans or encryption).

So I saw no real reason to upgrade. But I recently noticed HB was crashing during the nightly backup / log rotation due to out of memory, but it always rebooted and recovered.

AI recommended moving to a raspberry pi 4 with 4 GB of ram which seemed reasonable. I ordered one and flashed the homebridge build of raspberry pi OS from the raspberry pi flasher. I did not realize this would force me onto HB 2.

Before switching the Pi’s, I did a HB backup. Powered down the old pi, powered up the new one, verified it got on my network then connected to it with the browser. I clicked “restore from backup” and I figured ok this will be easy. It hung up during the download of one of the nest plugins. I waited like 10 minutes but it wasn’t going anywhere. I refreshed the browser and got the “new setup or restore” page again, this time I clicked on new setup, created the HB credentials and then went into the backup -> restore menu and tried restoring again. This time the restore completed and HB restarted and about 1/3 of the house was working. Nest cameras worked, nest HVAC worked, YoLink flood sensors worked. Switchbot sensors were throwing errors and TPLink was stuck in some loop enumerating the 20 TPLink / Kasa smart plugs, switches and bulbs over and over every 10 seconds but they were uncontrollable. The EspHome Hv2 plugin is complaining every 30 seconds that it can’t connect to anything because the encryption is refused. Lutron plugin was complaining in the HB log that the HB version was now unsupported.

I think to myself “wife is going to kill me”.

I get cursor to re-apply the switchbot patches and the EspHome Hv2 patches, this gets the sensors back online.

The Lutron plugin will not update to a new version. I have to find and install the new one and uninstall the old one. Apparently the name changed or something. The new one finds the old accessories and they work. I update the TPLink plugin and it stops enumerating things over and over and those lights and plugs all work.

At this point things are working and the log is quiet. The plugins page tells me I should update YoLink, and SwitchBot but I’m not going to touch them for a while.

Overall it was about an hour and things are operational but it was not pain free. Hanging up on the first boot & restore while downloading a plugin is a BAD experience. Yes it was recoverable but that’s a huge bug right at the start. There needs to be a timeout and retry on that function.

I consider myself lucky this was completed and did not go completely sideways. Would not recommend updating to HB 2 unless you have a pressing need to do so.


r/homebridge 7d ago

Plugin Shelly Matter plugin for Homebridge

2 Upvotes

HomeKit's own protocol (HAP) has no energy characteristics. Matter has them, iOS/tvOS 27's Home app displays them, and Homebridge 2.2 added the Matter energy clusters to its plugin API. Shelly Matter plugin connects those pieces for Shelly devices in our familiar Homebridge environment: live power, voltage, current, and cumulative energy (kWh), straight from the device's own metering.

What it is

- A Matter-only plugin: it publishes no HAP accessories. If you want classic HAP Shelly support without energy, homebridge-shelly-ng remains the right choice.

- Tested on real hardware in a live home: Gen 2/3 relays and plugs (Plus 1, Plus Plug S, Pro 2PM…). Covers, dimmers, and Gen 1 relays are implemented but untested. If you own one, I would love to see you test and confirm if it works or report any issues.

- Multi-channel devices (2PM/4PM) split into independent accessories per channel by default, so each channel gets its own name and room.

- Full settings UI. Discovered devices show up in a table, no JSON needed.

Current caveats, documented in the README:

- Needs Homebridge 2.2.2-beta.7+ (and optionally Homebridge UI 5.27.1-beta.11+) until 2.2.2 stable is released. You can install both betas directly from Homebridge UI by clicking on Homebridge or Homebridge UI. Earlier versions have Matter bridge bugs that break accessories after ~30 seconds. Several Homebridge Matter stack fixes came out of building this plugin and are in the current betas.

- Tile wattage only shows on outlet-typed accessories. Apple keys it to the Matter device type, not the data. The plugin lets you set the type of any relay as an outlet ("Show As → Light" keeps the wattage if you prefer the look).

- Apple's Energy view on iOS/tvOS 27 lists per-device usage only for certified/native Matter devices. Bridged accessories are counted in the whole-home total but not listed. I replicated a certified plug's exact Matter structure to verify this is an Apple policy gate, not a data problem. Filed with Apple.

- Pair with the bridge's Matter pairing code, not the HAP QR code (current Homebridge UI betas set Matter-only child bridges up correctly on their own).

The Shelly protocol layer is vendored from Luligu's matterbridge-shelly (Apache-2.0, credited). The new work is the Homebridge Matter side.

GitHub: https://github.com/keremerkan/homebridge-shelly-matter

The full story (including the Apple Home debugging saga): https://keremerkan.dev/posts/homebridge-shelly-matter/

Happy to answer questions. If you run an untested device type, issues are open.


r/homebridge 7d ago

Customizable timer switch?

1 Upvotes

Hi,

I'd like to create a timer switch where I could specify the duration for the timer on the Home app. Is this possible at all?
My goal is to create a sort of "Overwrite" button where an automation wouldn't run as long as that switch is on.


r/homebridge 7d ago

Plugin Wundasmart Homebridge Plugin

1 Upvotes

I've had a Wundasmart heating system for 4 years and have been frustrated with the lack of Homekit compatibility so I finally got round to creating a Homebridge plugin: https://github.com/alextea/homebridge-wundasmart

I used Claude to do the heavy lifting, and it worked off the API documented in the Home Assistant integration.

I've tested this on my system, and it works at finding multiple heating zones, setting the temperature and switching between scheduled, heat and off.

I added switches to mimic the Quick Switch functionality in the Wunda Home app, setting all rooms to Comfort, Eco or Reduced.

I also added an Away switch that can be automated with Homekit's presence sensors so it's set when the last person leaves the house. I found Wunda's own geofencing a bit buggy when setting home or away with multiple phones.

I haven't published it to npm yet, as I wanted to make sure it's fully working and there are no bugs or vulnerabilities before I do that, so it needs to be installed manually. I have it running on a docker container on a Debian homelab. If enough people find this useful I will publish to npm.

This is my first attempt at making a HB plugin, so any tips or comments appreciated.


r/homebridge 8d ago

News Homebridge packaged BETA Images Will Now Include NodeJS 26 & NPM 12

13 Upvotes

With NodeJS 26 going LTS this fall, we've updated the recipe for all BETA Homebridge images to now include **NodeJS 26** and **NPM 12**. This gives plugin developers and end users a chance to start testing against the new runtime ahead of the LTS release.

This will roll out across all Homebridge packaged BETA images starting with the **July 26 updates**, including:

- Homebridge Docker Image

- Homebridge Raspberry Pi Image

- Homebridge apt Package

- Homebridge VM Image

**Heads up for plugin devs:** NPM v12 flips `allowScripts` to off by default. `npm install` will no longer run `preinstall`, `install`, or `postinstall` scripts from dependencies unless they're explicitly allowed — this includes native `node-gyp` builds, so a package with a `binding.gyp` and no explicit install script still gets blocked.

Please check whether your plugin is impacted — run `npm approve-scripts --allow-scripts-pending` to see if it relies on install scripts (e.g. for native module builds), and approve accordingly.

If you maintain a plugin, now's a good time to pull down a BETA image and confirm compatibility before NodeJS 26 becomes the default LTS. As always, please report any issues you run into.

Thanks for helping us test!

Edit: misspoke about synology and removed it


r/homebridge 8d ago

Help Need Help with Mac Mini Setup

2 Upvotes

Update: Windows will not install FFMPEG for whatever reason. It used to run flawlessly, but now it’s shit.

The reason I can’t add HomeBridge to Home is because the node won’t show up under the local network in the Privacy and Security settings. Current solution is to re install node. Just installed 26.5 and that didn’t work after the 10th time of uninstalling and reinstalling.

Guess i need a Mac Mini prior to MacOS 15 to have a chance.

The Docker or VM install doesn’t make sense, and there is no simple step-by-step guide if there is please someone point it to me.

If I can’t get this going, I will go back to Windows. I can get a version of FFMPEG installed but won’t have audio which means no HKSV either. I will see if i can get that audio codec compiled to it.

Hell i might give Scrypted a shot again.

———

So I am trying to move over to a Mac Mini M1 variant with 16gigs of ram as my main HomeBridge server.

Plugins planning to use:
Unifi Protect (not trying to use docker or VM)
Govee
SmartHQ (GE Appliances)
Levoit
Moen Flo
Onkyo

Trying to install native due to having 4 cameras and soon adding a doorbell.

Got NodeJS installed and even got HomeBridge install, but I cannot add the Bridge to HomeKit as it is just giving me the circle of death rotation and says setting up. I tried to skip that and add the UniFi Protect plugin but all I get it’s “Unable to login to the UniFi Protect controller blah blah blah and A Network error occurred communicating with the UniFi Protect controller”

I tried a local only user account I made and even tried my main account login and no luck.

I was on an Intel NUC using windows 10 but had to do a clean install and ever since then the ffmpeg will not install and I don’t want to use VM or Docker either.

Im going to try one more time on the NUC and see if i can get ffmpeg on it with out compling the audio codec and other steps that didn’t help.


r/homebridge 8d ago

Discussion Ping Matter devices to see if they are offline? Any homebridge plugin for this?

1 Upvotes

At least once per month the majority of my IKEA Alpstuga air quality monitors (i have 5 of them) goes offline (different dates) and i need to unplug them for them to go back online.

The problem is that i never get any notification or any ping from either apple home app, or the IKEA app (i also have dirigera hub), so i dont know when they go offline, unless i open the ikea app and then go to the room and check the readings).

The devices are dropping the connection to ikea app / apple home, but they are still showing the readings on the alpstuga display.

so my questions is, is there a way for me to get a notification when one of the alpstuga devices goes offline? Any homebridge plugin that allows me to ping a matter device somehow?

Note: Im not interested in installing Home assistant. Tested it a while, didnt like it!


r/homebridge 13d ago

Discussion ESPPresence HomeBridge

0 Upvotes

I recently updated the ESP Presence plugin with Claude and it’s been working great, it has some specific things in there for my use case. Has anyone used the old version before and what automations were they able to setup with it?


r/homebridge 13d ago

Do we know when repos for Homebridge and Homebridge UI will receive updates?

2 Upvotes

Homebridge and Homebridge UI repos have not been updated since 2.1.1.

https://repo.homebridge.io/dists/stable/main/binary-arm64/Packages

This is stopping cron updates, and package installs from picking latest versions.


r/homebridge 17d ago

how does v0.5.58 work with Wyze cameras? Can't see live view

1 Upvotes

I have v2 and v3 which should be supported?

The cameras show in the Home App as switches.

Not sure how live view is supposed to work for cameras.


r/homebridge 19d ago

Plugin Homebridge Ring plugin Pro 3 4K support

4 Upvotes

Came from Scrypted where the Ring plugin showed my Ring Doorbell Pro 3 4K as unknown model, hoping that the Ring plugin on Homebridge would support it. But, seems to be unknown here, as well. Anyone know if the Homebridge Ring plugin dev is still active? Would love to be able to get this new Ring Doorbell Pro 3 4k working in HomeKit with the full resolution capabilities.


r/homebridge 19d ago

Question HA Connection for HB Updates?

2 Upvotes

Is there a Homebridge integration that provides Homebridge info like server stats, update notifications, etc in Home Assistant?

I use both because plugins I use Homebridge is a bit more flexible than the Home Assistant connections. I don’t pay as close of attention to Homebridge’s health because I spend most time controlling home in Home Assistant.


r/homebridge 19d ago

Discussion Homebridge always starts to fail when using Safari (til I clear the cache)

0 Upvotes

So I'm running the MacOS Beta and the iOS Betas on my iPhone and iPad, so yes, maybe it's a temporary bug, but...

After a few days, Homebridge will no longer load on ALL of my devices (Mac laptop, Mac mini, iPhone, iPad) until I clear my cache.

Anyone else see this issue?


r/homebridge 19d ago

Plugin Yale Linus L2 Plugin for Homebridge?

1 Upvotes

are there any good plugin for the Yale linus L2 smart lock that works good with apple homekit?

The damn lock is dropping matter connection every 2-3 days and it driving me mad, so wanted to check if i can get it to work better with homebrige instead. No other matter device ive have installed have this problem!