Skip to content
oznu edited this page Mar 23, 2020 · 46 revisions

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 issues that may arise while installing third party software.

SSH Access

Networking

Third Party Apps

Node.js

SSL / HTTPS

Homebridge Instances

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)