How to Install Homebridge on a Raspberry Pi (Step-by-Step)

Quick answer: The easiest way is to flash the official Homebridge Raspberry Pi image onto a microSD card (or SSD) with Raspberry Pi Imager, boot the Pi on your network, open http://homebridge.local:8581 in a browser, and follow the setup wizard. Then scan the QR code in the Apple Home app and start adding plugins. Plan on 30–60 minutes the first time.

What Homebridge does (and whether you need it)

Homebridge is free, open-source software that makes devices without native Apple HomeKit support show up in the Apple Home app. Plugins written by the community act as translators between Apple Home and thousands of devices and services.

Before you start, check whether you even need it. Many devices now support Apple Home directly or through Matter, and some hubs (including Hubitat) can expose devices to Apple Home on their own. Homebridge shines when you have a device that doesn’t, or when you want features the native integration doesn’t offer.

What you’ll need

• A Raspberry Pi. A Raspberry Pi 4 or Raspberry Pi 5 is a comfortable choice. Homebridge is light, so you don’t need the top memory option.
• Official power supply. Underpowered Pis cause weird, hard-to-diagnose problems. Use the official supply for your model.
• Storage. A good-quality microSD card (A2-rated, 32 GB is plenty) or, for better long-term reliability, a USB or NVMe SSD.
• A case with cooling. Especially for the Pi 5, a case with a fan or the official active cooler is a good idea.
• An Ethernet cable (recommended). Wired is more reliable than Wi-Fi for a device that runs 24/7.
• A computer to flash the card, and an Apple device (iPhone, iPad or Mac) with the Home app. An Apple home hub (HomePod or Apple TV) is needed for automations and remote access.

Step-by-step installation

Step 1: Install Raspberry Pi Imager

Download Raspberry Pi Imager from the official Raspberry Pi website and install it on your computer (Windows, macOS or Linux).

Step 2: Choose the Homebridge image

Open Imager, choose your Pi model, then go to the operating system list. The Homebridge image is listed under the home automation / specific-purpose OS section. Select it, then choose your microSD card or SSD as the storage target.

Menu names in Imager change from version to version. If you can’t find it, download the image from the Homebridge project’s GitHub page and use “Use custom” in Imager.

Step 3: Set up Wi-Fi (only if you’re not using Ethernet)

If you’ll use Ethernet, skip this. If not, follow the Homebridge image’s current instructions for Wi-Fi setup. Depending on the version, this is done either in Imager’s settings before writing or through a temporary setup hotspot the Pi creates on first boot.

Step 4: Write the image and boot the Pi

Write the image, put the card (or SSD) in the Pi, connect Ethernet, and plug in power. Give it a few minutes on first boot — it’s setting itself up.

Step 5: Open the Homebridge UI

On a computer on the same network, go to http://homebridge.local:8581. If that doesn’t load, find the Pi’s IP address in your router’s device list and use http://[IP address]:8581 instead. Create your admin account when prompted.

Step 6: Add Homebridge to Apple Home

The Homebridge dashboard shows a QR code. Open the Home app on your iPhone, tap + > Add Accessory, and scan it. You’ll see a warning that it’s an uncertified accessory — that’s normal for Homebridge. Tap “Add Anyway.”

Step 7: Update and back up

In the UI, apply any updates offered for Homebridge, the UI and Node.js. Then create a backup from the settings menu and save it somewhere other than the Pi.

Your first plugins

Install plugins from the Plugins tab in the Homebridge UI. Search, install, then fill in the settings form. A few popular ones to look at:

• Hubitat: community plugins can bring Hubitat devices into Apple Home. Note that Hubitat also offers a built-in HomeKit integration, so compare both.
• Sonos: plugins such as homebridge-zp expose Sonos speakers to Apple Home for things like volume and on/off in scenes.
• Alexa: the homebridge-alexa plugin works in the other direction, letting Alexa control devices you’ve added to Homebridge.
• Cameras: camera plugins can bring many RTSP cameras into Apple Home.

Prefer plugins marked as Verified in the Homebridge UI, and check that a plugin supports the current major version of Homebridge before installing.

Note that Lutron Caséta already works with Apple Home natively through the Lutron hub, so you don’t need Homebridge for it.

Use child bridges

In each plugin’s settings, you can enable a child bridge. This runs the plugin in its own process, so if one plugin crashes or misbehaves, it doesn’t take down the rest of Homebridge. For a reliable setup, turn this on for most plugins.

Troubleshooting common problems

“homebridge.local” won’t load

Some networks and devices don’t resolve .local names well. Use the Pi’s IP address from your router. Setting a DHCP reservation for the Pi in your router keeps that address from changing.

Accessories show “No Response” in Apple Home

Check the Homebridge logs in the UI first. Common causes: a plugin crashed (child bridges help here), the Pi lost network, or multicast/mDNS traffic is being blocked by mesh Wi-Fi or router settings. Restarting Homebridge from the UI often clears it.

The Pi keeps rebooting or freezing

Usually power or storage. Use the official power supply and replace a worn microSD card — or move to an SSD.

A plugin stopped working after an update

Check the plugin’s GitHub page for known issues, roll back to the previous version from the plugin’s menu in the UI, or restore your backup.

Homebridge can’t be found when adding to Home

Make sure your iPhone is on the same network (not a guest network) as the Pi. If you’ve added and removed it before, you may need to reset the Homebridge pairing from the UI settings.

Keeping it reliable long-term

• Use Ethernet, not Wi-Fi.
• Run plugins as child bridges.
• Don’t install plugins you don’t need.
• Read release notes before big updates.
• Keep regular backups off the Pi.
• Consider an SSD instead of a microSD card.

FAQ

Which Raspberry Pi is best for Homebridge?

A Raspberry Pi 4 or 5 is a comfortable choice for most homes. Homebridge doesn’t need much power, so an older Pi you already own may be fine for a small setup.

Is Homebridge free?

Yes. Homebridge and its plugins are free and open source. You only pay for the hardware.

Do I need an Apple TV or HomePod?

Not to add devices, but you need an Apple home hub for automations and controlling things when you’re away from home.

Can I run Homebridge on something other than a Pi?

Yes. It also runs on Linux, macOS, Windows, Docker and some NAS devices. A Pi is just the cheapest, most popular always-on option.