Home

The Homebridge Raspberry Pi Image is built on Raspbian Lite and is intended to be used as a "headless" server, meaning there is no need to connect a monitor, keyboard or mouse to your device.

Since the Homebridge Raspberry Pi Image is running Raspbian Linux, if you are trying to figure out how to do something that is not Homebridge specific, you should search for instructions related to recent versions of Raspbian Linux elsewhere. The Homebridge project team does not provide support for issues that may arise while installing third party software.

Quick Start Guide

• Getting Started

Updating

• How To Update Homebridge and Node.js Packages

SSH / VNC Access

• How To Connect Via SSH
• How To Connect Via VNC

Networking

The Homebridge Raspberry Pi Image uses NetworkManager to manage network connections.

• How To Setup WiFi
• How To Find IP Address
• How To Reset WiFi
• How To Disable WiFi Setup Portal

Third Party Apps

• How To Install AdGuard Home
• How To Install Pi Hole
• How To Install deCONZ for ConBee or RaspBee

SSL / HTTPS

• How To Access Homebridge UI via SSL/HTTPS

Homebridge Instances

The Homebridge Wiki contains more generic Homebridge information and help articles.

• How to Add / Remove Homebridge from HomeKit
• Homebridge Config JSON Explained
• How To Enable Debug or Insecure Mode
• How to Backup and Restore Homebridge

Useful Commands

Action	Command
Restart Command	sudo hb-service restart
Stop Command	sudo hb-service stop
Start Command	sudo hb-service start
View Logs Command	sudo hb-service logs
Update Node.js	sudo hb-service update-node
Manage Homebridge Server	sudo hb-config

Default Settings

	Default Value
Default Hostname	homebridge.local
Default SSH Username	pi
Default SSH Password	raspberry

File Paths

	Path
Homebridge Config File	/var/lib/homebridge/config.json
Homebridge Storage Folder	/var/lib/homebridge
Homebridge Systemd Service File	/lib/systemd/system/homebridge.service
Homebridge Systemd Override File	/etc/systemd/system/homebridge.service.d/override.conf
Homebridge Nginx Config	/etc/nginx/sites-enabled/homebridge.local
Homebridge Nginx SSL Key	/etc/nginx/ssl/homebridge.local.key
Homebridge Nginx SSL Cert	/etc/nginx/ssl/homebridge.local.crt

Default Ports

These are the ports that are open / in use on a standard, unmodified installation of the Homebridge Raspberry Pi Image.

Service	Port
SSH	22
HTTP Nginx -> Homebridge Web UI	80
HTTPS Nginx -> Homebridge Web UI	443
HTTP Homebridge Web UI	8581
Homebridge	51000-52000 (randomly assigned on first boot)
Bonjour	5353/udp