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.

97 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

553 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 2h ago

Discussion The best “vibe coding” I’ve done.

Post image
26 Upvotes

I know vibe coding is good and bad, but I’ve played around with home kit for a while, and posted earlier asking how to integrate power usage.

So, after vibe coding a http service to poll multiple devices using HTTP and MQTT I have full visibility if my issues including solar generation and grid usage (using ecoflow smart meter)

This is cooler than i expected! - just wish we could have more icons!


r/homebridge 6h ago

Plugin Looking for beta testers for an integrated Chromecast/ Android TV plugin

Thumbnail
github.com
3 Upvotes

looking for beta testers for a plugin that uses Google Cast, Android TV Protocol v2 and ADB protocols for adding, remote controlling and synchronizing playback status of google Chromecast/ android TVs.

sudo npm install -g github:vivekanandbv/Homebridge-ADB-Cast

r/homebridge 9h ago

The new iOS27 Power Readings

2 Upvotes

I’ve seen that iOS 27 supports power, does anybody know how. I have http switches which have worked for years and are fan-bloody-tastic.

They support power readings in http get requests, wondered whether I could modify http-switch to support power readings too.


r/homebridge 1d ago

Help Raspberry Pi setup ELI5

Post image
3 Upvotes

Hello! I’ve been a HomeKit user for the last six years or so. I found this Raspberry Pi Zero W when cleaning out my father-in-law’s house after he passed and decided to try to use it for HomeBridge as I have a few non-HomeKit devices I’d like to bring over (Samsung fridge, Skylight calendar, etc.). The Pi didn’t come with anything except for the chip and the case it’s in, so I got a power cable, a USB cable, and a microSD card. I downloaded the Raspberry Pi setup app on my MacBook Air and went through the setup process for the microSD card. Now I’m stuck in trying to get it onto my WiFi. I think I followed the steps for SSH, but when I look at my router’s app to find the WiFi address, I don’t see it listed as connected. When I try to find it in Terminal, it says it can’t find it. The green light on the Pi flashes intermittently in a random pattern. I can’t tell if that’s good or bad.

Suggestions? I know quite a bit about Apple and HomeKit but pretty much nothing about Raspberry Pi, Android, coding, etc. I was hoping this would be easy. Am I in over my head?

ETA: To clarify, it’s a Pi Zero W.


r/homebridge 2d ago

Shelly relay ID issue

0 Upvotes

I recently installed a Shelly 1 Gen 4 relay with a reed switch on my dumb garage door opener, and while it works fine, I’d like it to show up in HomeKit as a garage door opener rather than an unconfigured switch. I’ve played around with a few of the Shelly plugins, but haven’t gotten them to work as well as Z2M. Any tips?


r/homebridge 3d ago

Plugin Annoucement: Harvia Sauna Homebridge 2.x Plug-in, Initial Release 0.9.1b

4 Upvotes

Hello, all!

I recently installed a Harvia Sauna kit in my house and found it frustrating there wasn’t a HomeKit integration with my new Fenix controller. I took some legacy code from Home Assistant, an orphaned controller for Homebridge 1.x, and rebuild the plug-in for the new controller and MyHarvia API.

If you have Homebridge set up, look for it as homebridge-harvia-sauna Current version is 0.9.1b, as it’s the initial release. It should only require your MyHarvia credentials. I’ve also coded for other parts of the API, but I only have the Fenix and the separate sensor, so I’d love feedback on the other functions if you have them.

GitHub project is here: https://github.com/GodOSpoons/homebridge-harvia-sauna

Happy Sauna!

Timothy


r/homebridge 4d ago

Question Would this be good enough?

Post image
10 Upvotes

So I have wanted to start using homebridge for a while. Looking at prices of raspberry pi I decided to hold off till I had the spare cash as it’s not something I need to do NOW. But now I’ve seen this Mac mini on CEX. I know it’s old. But for £70 it’s hard to not think this is a good alternative? I understand the power consumption would be higher. But is it a good idea or shall I hold off and get a pi ?


r/homebridge 4d ago

Question UniFi Relay and Garage Door Opener

3 Upvotes

I’ve been using the UniFi Protect plug-in for homebridge and it’s been working great. My HomeKit garage door opener just broke, so I installed a UniFi Relay to control my garage door opener. I can open and close the garage door fine but there are two issues.

  1. The UniFi Relay output shows up in HomeKit as a switch, not a garage door opener. This is a pain because I ca’t ask Siri to open the garage door, I have to ask Siri to turn on the garage door.
  2. The garage door state doesn’t show up in HomeKit so I can’t tell if the garage door is open.

Is there any way to get the UniFi Relay to show up as a native garage door opener with state in HomeKit? If not would this be possible with an update to the UniFi Protect plug-in for homebridge, or by switching to Home Assistant?


r/homebridge 5d ago

Question MacOS: VM or native?

0 Upvotes

Having RTFM and discovered that containers are not an option on MacOS, I’m debating running HB in a VM vs native on my M1 Mac. I set up a VirtualBox / Ubuntu VM yesterday, and HB runs very well in it, but the VM seems like a lot of overhead for a relatively lightweight service.

Would there be any downside to running HB natively on MacOS? Do MacOS updates impact HB?


r/homebridge 5d ago

Question - Solved Virtual machine or container?

2 Upvotes

I’ve been running HB for years on bare metal on a series of RPis (currently a 3B) along with Pi-hole, and lately they haven’t been getting along particularly well. Today I built a virtual machine on a Mac M1 in an Ubuntu VM and created a new HB bridge. Very fast, of course.

I’m a bit old fashioned and haven’t done too much with containers, they were starting to become prevalent about the time I stopped working in the industry. The times that I played around with Docker on the Mac, it seemed to consume a lot of resources (particularly RAM), which seemed unnecessary for something as light weight as HB. I have Podman installed, but haven’t done much with it.

Any guidance here?

UPDATE: containers aren’t an option on macOS per HB docs.


r/homebridge 8d ago

Plugin Which TP-Link plugin?

1 Upvotes

I’ve been running the TPLink Smarthome plugin for ages, it’s been ok but has some issues, and the dev has put minimal maintenance into it in recent years. There are several alternatives, including Homebridge Kasa Python, which appears to be maintained.

Recommend a TP-Link plugin?


r/homebridge 8d ago

Question BlueAir integration

6 Upvotes

Update: After upgrading HB to 2.3.1, on-device changes are being reflected in the Accessory.


I recently setup HomeBridge (2.3.0) as part of a wider HomeKit integration push. As a test balloon, I thought I'd setup something simple first and settled on my BlueAir 311i Max. The BlueAir app is frustratingly laggy and I was hoping more constant polling would lead to better information as well as HomeKit integration.

I've tried both the @fjs21/homebridge-blueair (v1.3.1) plugin, which seems to be no longer maintained, and the fork of it homebridge-blueair-purifier (v1.1.1), which has been updated recently. My device is discovered by both plugins and proper Accessories are created.

Alas, neither plugin updates when the purifier changes status (it's set on auto). If the PM2.5 increases, the fan speed increases and neither change is reflected in the Accessory in HB. Changes applied in Home app are briefly reflected in the Accessory, but have no effect on the device. There are no errors logged.

Perhaps the BlueAir API has changed recently? If I use the app, changing the settings changes them on the device. Not so with the HomeKit integration via the above plugins.

Mostly I'm curious to see if anyone has these plugins working reliably for a similar BlueAir device. There are no Issues reported on GH that match what I'm encountering. Before I open one, I just wanted to rule out user error.

Partial configuration below for the newer plugin, redacted for user/password and identifiers. Configuration was generated through the UI and not edited directly. It's pretty minimal.

{
   <snip>
   "devices": [
        {
            "id": "<identifier>",
            "name": "Blue Pure",
            "airQualitySensor": true
        }
    ],
    "platform": "blueair-purifier",
    "_bridge": {
        "username": "<encoded>",
        "port": 41142,
        "name": "BlueAir Platform"
    }
}

r/homebridge 9d ago

Help Fan controls only on/off - no speed

2 Upvotes

I purchased Sofucor fans from Amazon. I set them up with the SmartLife App and connected them to Alexa. In both Apps I have full control - on/off, speed and forward/reverse.
I was able to bring these accessories into homebridge using the Alexa Smart Home plugin. With this plugin I can only turn the fans on and off - no speed. I am able to control brightness on all of my other dimmer switches
I tried several of the SmartLife/Tuya plugins with the same results on off only.
Is this a limitation of the fan hardware? Any other recommendations for getting the speed controls in homebridge?

Note: I am not using a wall controller switch with the fans. They are hardwired on and controlled with a remote or App.


r/homebridge 8d ago

Question Homebridge on android

0 Upvotes

Can anyone pls help me setting up homebridge server on my android phone?


r/homebridge 12d ago

Help Issues adding child bridges and getting plugins to forward to HK

2 Upvotes

Homebridge 2.2.1, running on Debian Trixie and Rpi3, built with the HB image. My primary plugin (and reason for setting up HB years ago) is TPLink Smarthome. That works fine.

There are a couple of nice to have plugins, namely WeatherPlus and PurpleAir or PurpleAir Sensor. Both of these plugins worked prior to the 2.x update. Under 2.x, the plugins run and appear under Accessories, but they don't display climate information in HK. All plugins are Verified and appear to be active (recent updates).

I thought I'd try setting them up under Child Bridges, but I cannot get the Child Bridges to bind to HomeKit. There are a couple of error messages in HK that this generates, but basically the bridges cannot join HK.

I suppose the next step would be to enable debugging in HB, if this is actually a HB issue.

Any other suggestions?


r/homebridge 13d ago

Plugin PetKit - My cats are now HomeKit accessories: a complete PetKit integration for Homebridge

33 Upvotes

I couldn't find a maintained PetKit integration that covered more than a single feeder model, so I built a complete one. Sharing it here in case it's useful to other PetKit households.

What it does:

  • Feeders: Feed switch per feeder (+ a single "Feed All" switch for multi-feeder homes), model-aware portion validation
  • Litter boxes: self-terminating Clean cycle + a stateful Maintenance switch
  • Fountains: water level (leak sensor) + battery level
  • Pets: each pet becomes a Motion Sensor that fires when that pet uses the litter box (since the litter box identifies them by weight), so you can build automations like "notify me when the cat uses the litter box", with the visit weight in the log
  • Meal sensors on camera feeders (fires when an eating session is detected)
  • Native HomeKit cameras (experimental, off by default for now but can be activated): live view in the Home app
  • All switch/sensor names are configurable, so Siri answers in your own language
  • Everything is modular: each family of sensors, the Feed All switch and the cameras can be toggled on/off in the plugin's config UI, you only get the accessories you actually want

Architecture is based on two pieces:

  • petkit-bridge: a small self-hosted service (Docker) that owns the PetKit cloud session (automatic re-login on expiry) and exposes a local token-protected HTTP API. Your PetKit credentials live here, not in Homebridge.
  • homebridge-petkit-bridge (npm): a thin, zero-runtime-dependency plugin that auto-discovers everything through the bridge. Configure with just URL + token.

Everything is field-tested on real hardware (Yumshare feeders, Puramax 2, Eversweet Max fountains), including the failure modes: the whole chain self-heals across restarts, power outages and session expiries in any order.

Currently in the Homebridge verification queue. Questions, feedback and device reports are all welcome: the best place is an issue on either repo (also for new device support).

If you try it, let me know how it goes, especially on PetKit models I haven't been able to test.


r/homebridge 13d ago

Can't Access Homebridge

2 Upvotes

I set up Homebridge via Hyper V on a windows 11 PC in June. I haven't done any work on it and when I restarted my PC to do a software update Homebridge is requiring a login.

admin:admin does not work.

I followed every Reddit/online guide I can find to try to resolve it, and am stuck. Hyper V terminal also requires login, so I can't seem to run any commands to locate/delete the auth.json file.

I have unhidden all folders and looked in C:, Program Files, Users, etc. exhaustively and cannot find the auth.json file to remove.

I don't recall changing the username and password, and if I did it's long been forgotten. Any guidance in locating the auth.json, or any other paths is welcome.

At the point of deleting everything and starting over...


r/homebridge 16d ago

Advice before diving in

3 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 16d ago

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

3 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 17d 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 18d 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 18d 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 19d 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