Before you start
Go through this list before you install anything. Setup takes four steps, and each one needs something from this list.
What you need
Section titled “What you need”- Homebridge 2.5.0 or newer, with the Homebridge UI. Homebridge is a program that runs on a small computer in your home, such as a Raspberry Pi or a NAS, and adds devices that Apple does not support to the Home app. The Homebridge UI is the web page you use to manage it. The Status page of the Homebridge UI shows which version you have. Homebridge 1.x and the 2.x releases before 2.5.0 do not work.
- Node.js 22 (22.12 or later), 24 or 26. Node.js is the software Homebridge runs on. Homebridge’s own install images include it, so you usually do not install it yourself. The Status page of the Homebridge UI shows which version you have. Node.js 23 and 25 do not work.
- A Bosch or Siemens fridge, freezer or fridge-freezer. It must already be set up in the Home Connect app on your phone, and connected to the same home network as your Homebridge machine.
- A desktop or laptop computer, once. It can run Windows, macOS or Linux. You use it in Step 2 to download your appliance profiles. A phone or tablet will not do.
- Your Home Connect login, once. This is the email and password you use in the Home Connect app. Home Connect calls it a SingleKey ID. You type it into the download tool in Step 2, never into Homebridge.
- An internet connection, once. Step 2 needs it. Nothing after Step 2 does.
- An iPhone or iPad with the Home app. You add the appliance to Apple Home in Step 4.
Which appliances work
Section titled “Which appliances work”The plugin works with three kinds of Home Connect appliance from Bosch and Siemens:
- fridges
- freezers
- fridge-freezers
It has been tested on one Bosch KSN36VICG fridge and one Bosch GSN36VICG freezer. Other fridge and freezer models have not been tested yet.
Ovens, dishwashers, washing machines, coffee machines and every other kind of Home Connect appliance are not supported. If you import a profile for one of them, the plugin skips it and says why. The message ends with is not supported in this version.
If Homebridge runs in Docker
Section titled “If Homebridge runs in Docker”Docker is a way of running Homebridge inside a sealed-off box called a container. It is common on NAS devices. A container can stop the plugin from finding your appliances on the network. If your Homebridge runs in Docker, read Docker and NAS before you start.
How you know it worked
Section titled “How you know it worked”Every box in What you need is ticked. If one is not, sort it out first, because a later step will stop there.
Next: Step 1: Install the plugin.