Homebridge¶

Homebridge is an IoT bridge for HomeKit that brings support to iOS's HomeKit to smart home devices that originally do not provide support for it.

There is an official image for this service that we'll use: homebridge/homebridge.

Pre-Installation¶

We'll create a folder in the main user's home where all the service's data will be saved.

mkdir ~/services/automation/homebridge

Docker Compose¶

Homebridge will be run using Docker Compose. The content of the docker-compose.yml file is as follows:

services:
  web:
    image: homebridge/homebridge:latest
    restart: unless-stopped
    network_mode: host
    volumes:
      - ./data:/homebridge
    environment:
      TZ: America/Guayaquil

Post-Installation¶

We'll need to allow the service's port on our firewall.

sudo ufw allow 8581/tcp
sudo ufw allow 51845/tcp
sudo ufw allow 51845/udp

Note

Make sure to check the 51845 port applies for you, I believe this port is chosen at random when setting-up Homebridge. You can check this by reading the output logs when setting-up this service.

Running¶

Start up the service with:

docker compose up -d

That's it! The service will auto-start on system startup and restart on failure.