This Alpine Linux based Docker image allows you to run Nfarina's Homebridge on your home network which emulates the iOS HomeKit API.
Homebridge requires full access to your local network to function correctly which can be achieved using the --net=host
flag.
Currently this will not work when using Docker for Mac due to this issue.
Quick Setup:
docker run
--net=host
--name=homebridge
-e TZ=<timezone>
-v </path/to/config>:/homebridge
oznu/homebridge
This image will also run on a Raspberry Pi using the raspberry-pi
tag:
docker run --net=host --name=homebridge oznu/homebridge:raspberry-pi
This docker image has been tested on the following Raspberry Pi models:
- Raspberry Pi 1 Model B
- Raspberry Pi 3 Model B
- Raspberry Pi Zero W
The parameters are split into two halves, separated by a colon, the left hand side representing the host and the right the container side.
--net=host
- Shares host networking with container, required.-v /homebridge
- The Homebridge config and plugin location.-e TZ
- for timezone information eg Europe/London, etc
The Homebridge config file is located at </path/to/config>/config.json
This file will be created the first time you run the container with a sample FakeBulb accessory.
Plugins should be defined in the </path/to/config>/package.json
file in the standard NPM format.
This file will be created the first time you run the container with the FakeBulb module.
Any plugins added to the package.json will be installed each time the container is restarted. Plugins can be uninstalled by removing the entry from the package.json and restarting the container.
You can also install plugins using yarn (an npm replacement) which will automatically update the package.json file as you add and remove modules.
You must restart the container after installing or removing plugins for the changes to take effect.
To add plugins using yarn:
docker exec <container name or id> yarn add <module name>
Example:
docker exec homebridge yarn add homebridge-hue
To remove plugins using yarn:
docker exec <container name or id> yarn remove <module name>
Example:
docker exec homebridge yarn remove homebridge-hue
If you prefer to use Docker Compose:
version: '2'
services:
homebridge:
image: oznu/homebridge
restart: always
network_mode: host
environment:
- TZ=Australia/Sydney
volumes:
- ./volumes/homebridge:/homebridge
Many issues appear because of invalid JSON. A good way to verify your config is to use the jsonlint.com validator.