ffmpegpre-compiled with audio support (libfdk-aac) and hardware decoding (h264_omx)
This image also provides a command called
hb-config which helps you keep Node.js up-to-date, perform maintenance on your Homebridge server, and install additional optional software such as Pi Hole, deCONZ, Node-RED and the UniFI Controller.
The Homebridge Raspberry Pi Image is completely free (no sign up required).
The easiest way to flash the Homebridge Raspberry Pi Image to your SD card is to use the Raspberry Pi Imager.
Raspberry Pi Imager will now download and flash the latest version of the Homebridge Raspberry Pi Image to your SD card, this may take several minutes depending on the speed of your internet connection and SD card.
Now that you have flashed your SD card, you can insert it into your Raspberry Pi.
Before powering on your Raspberry Pi decide if you want to use Ethernet or WiFi to connect to your network.
⚠️ An Ethernet connection is recommended as this provides the most simple and stable Homebridge setup.
If you have decided to connect your Raspberry Pi using ethernet, do so before you power on your device for the first time.
Follow these steps to connect your device to WiFi:
If you enter your WiFi credentials incorrectly the Homebridge WiFi Setup hotspot will reappear allowing you to try again.
The Homebridge Config UI X web interface will allow you to install, remove and update plugins, and modify the Homebridge config.json and manage other aspects of your Homebridge service.
The default user is
admin with password
If you're using macOS or a mobile device, you should be able to access the UI via http://homebridge.local.
If you're using Windows, or
http://homebridge.local does not work for you, you will need to find the IP address of your Raspberry Pi another way:
http://homebridge.local, once you login using the default username and password (admin/admin) you can find the IP address under System Information.
Once you've found your IP address, login to the web interface by going to
http://<ip address of your server>.
You should take a moment to review the Configuration Reference at the bottom of this guide.
To update Node.js run
sudo hb-config and select Upgrade Node.js.
This will ensure your Raspberry Pi is running the latest LTS version of Node.js.
SSH is enabled by default. The default username is
pi with password
The official Homebridge Discord server and Reddit community are where users can discuss Homebridge and ask for help.
This table contains important information about your setup. You can use the information provided here as a reference when configuring or troubleshooting your environment.
|File Location / Command|
|Config File Path||
|View Logs Command||
|Manage Homebridge Server||
|Systemd Service File||
|Systemd Env File||
|Default SSH Username||
|Default SSH Password||
|Default Web Username||
|Default Web Password||
The Homebridge Raspberry Pi Image wiki contains more information and instructions on how to further customise your install: