homebridge v0.1.0

Automation

Homebridge — a HomeKit bridge that brings non-HomeKit smart-home devices into Apple Home, with a web-based Config UI X. Deployed as a single host-networked Nomad service.

nomad-pack run homebridge --registry nomploy

…or one line (add registry + run)

curl -fsSL https://packs.nomploy.com/install.sh | sh -s -- homebridge

Needs nomad-pack on PATH. The script only adds the nomploy registry and runs this pack.

Source ↗ Project ↗ ★ 25.5k ⚑ Report an issue

1 task http 8581 1 volume image homebridge/homebridge:latest tracks :latest image bumped today

Variables 10

values.hcl

Save as values.hcl, edit, then run:

nomad-pack run homebridge -f values.hcl --registry nomploy

# The name of the Nomad job.
job_name = "homebridge"

# The Nomad namespace to deploy into.
namespace = "default"

# The datacenters to deploy to.
datacenters = ["*"]

# The Homebridge container image. Pin a tag in production.
image = "homebridge/homebridge:latest"

# Host port for the Homebridge Config UI X.
port = 8581

# Timezone for the container (e.g. Europe/Bratislava).
timezone = "UTC"

# Enable the built-in Avahi mDNS daemon for HomeKit discovery (1 = enabled, 0 = disabled).
enable_avahi = "1"

# Named volume for Homebridge config, plugins and persisted state (/homebridge).
config_volume = "homebridge_config"

# Placement constraints. On a nomploy cluster: attribute = "$${meta.nomploy_control_plane}", operator = "=", value = "true".
constraints = []

# The task resources.
resources = {
    cpu    = 500
    memory = 512
  }

Name	Type	Default	Description
job_name	string	"homebridge"	The name of the Nomad job.
namespace	string	"default"	The Nomad namespace to deploy into.
datacenters	list	["*"]	The datacenters to deploy to.
image	string	"homebridge/homebridge:latest"	The Homebridge container image. Pin a tag in production.
port	number	8581	Host port for the Homebridge Config UI X.
timezone	string	"UTC"	Timezone for the container (e.g. Europe/Bratislava).
enable_avahi	string	"1"	Enable the built-in Avahi mDNS daemon for HomeKit discovery (1 = enabled, 0 = disabled).
config_volume	string	"homebridge_config"	Named volume for Homebridge config, plugins and persisted state (/homebridge).
constraints	list	[]	Placement constraints. On a nomploy cluster: attribute = "$${meta.nomploy_control_plane}", operator = "=", value = "true".
resources	object	{ cpu = 500 memory = 512 }	The task resources.

Back up this pack

This pack stores data in one Docker named volume: homebridge_config

restic

# Run on the node hosting this pack. Point restic at your repo first:
#   export RESTIC_REPOSITORY="s3:https://<account>.r2.cloudflarestorage.com/<bucket>"
#   export RESTIC_PASSWORD="<repo-password>"
#   export AWS_ACCESS_KEY_ID=<key>  AWS_SECRET_ACCESS_KEY=<secret>
restic backup \
  /var/lib/docker/volumes/homebridge_config/_data

rclone (sync to S3/R2)

rclone sync /var/lib/docker/volumes/homebridge_config/_data backup:<bucket>/homebridge_config

Paths assume the default Docker volume location (/var/lib/docker/volumes). Restore by stopping the job, restoring files into the same volume, and re-running the pack.

Readme

homebridge

Homebridge is a lightweight server that emulates the Apple HomeKit API, letting you control smart-home devices that don't natively support HomeKit (thousands of plugins for cameras, lights, sensors, TVs and more) from the Apple Home app and Siri. It ships with Config UI X, a web dashboard for installing plugins and editing config.

This pack runs Homebridge as a single host-networked Nomad service. Host networking is required so HomeKit discovery (mDNS/Bonjour via the built-in Avahi daemon) works on your LAN.

Deploy

nomad-pack run homebridge --registry=nomploy

Open the Config UI at http://<node-ip>:8581 (default login admin / admin — change it immediately). Install plugins from the UI, then add the bridge in the Apple Home app using the PIN it displays.

Configuration

Variable	Default	Description
`image`	`homebridge/homebridge:latest`	Container image (pin a tag in production).
`port`	`8581`	Host port for the Config UI X.
`timezone`	`UTC`	Container timezone.
`enable_avahi`	`1`	Built-in Avahi mDNS daemon for discovery.
`config_volume`	`homebridge_config`	Named volume mounted at `/homebridge`.
`resources`	500 MHz / 512 MB	CPU and memory for the task.

All config, plugins and paired-accessory state persist in the config_volume under /homebridge, so upgrades and restarts keep your setup.