Home

The Homebridge Raspberry Pi Image 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 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

SSH Access

• How To Connect Via SSH

Networking

• How To Setup WiFi
• How To Find IP Address
• How To Set A Static IP Address
• How To Reset WiFi

Third Party Apps

• How To Install Pi Hole

Node.js

• How To Update Node.js

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 Homebidge from HomeKit
• Homebridge Config JSON Explained
• How To Enable Debug or Insecure Mode
• How To Setup Multiple Homebridge Instances
• 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
Manage Homebridge Server	sudo hb-config
Manage Network Connections	sudo nmtui

Default Settings

	Default Value
Default Hostname	homebridge.local
Default SSH Username	pi
Default SSH Password	raspberry
Default Homebridge UI Username	admin
Default Homebridge UI Password	admin

File Paths

	Path
Homebridge Config File	/var/lib/homebridge/config.json
Homebridge Storage Folder	/var/lib/homebridge
Homebridge Systemd Service File	/etc/systemd/system/homebridge.service
Homebridge Systemd Env File	/etc/default/homebridge
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