Skip to content

Homebridge Docker. HomeKit support for the impatient using Docker on x86_64 or Raspberry Pi (armhf).

Notifications You must be signed in to change notification settings

kenhuang/docker-homebridge

Repository files navigation

GitHub release Docker Build Status Travis Docker Pulls Slack Status

Docker Homebridge

Features

  • Able to use Alexa control all the HomeKit supported lights
  • Able to control IR device like Air conditioner, TV etc
  • Able to control wifi enable RGB LED lights (MiLight)
  • Able to review IP camera within iOS home app
  • Able to trigger video door bell from iOS home app
  • Able to control WeMo switch/motion sensor

Quick Start

Step 1

docker run \
  --net=host \
  --name=homebridge \
  -e HOMEBRIDGE_DEBUG=1 \
  -e HOMEBRIDGE_CONFIG_UI=1 \
  -e HOMEBRIDGE_CONFIG_UI_PORT=8888 \
  -e PUID=1000 -e PGID=1000 \
  -e TZ=Pacific/Auckland \
  -e PACKAGES=ffmpeg,openssh \
  -v /homebridge:/homebridge \
  kenhuang/docker-homebridge:latest
  
docker run \
  --net=host \
  --name=homebridge \
  -e HOMEBRIDGE_DEBUG=1 \
  -e HOMEBRIDGE_CONFIG_UI=1 \
  -e HOMEBRIDGE_CONFIG_UI_PORT=8888 \
  -e PUID=1000 -e PGID=1000 \
  -e TZ=Pacific/Auckland \
  -e PACKAGES=ffmpeg,openssh \
  -v /homebridge:/homebridge \
  kenhuang/docker-homebridge:raspberry-pi  

Step 2

update /homebridge/config.json, sample-config.json

Step 3

restart container

Step 4

add HomeBridge to iOS home app, check container logs get the QR code then add it as accessory in iOS home app

Included plugins

Gear list

  • DLink cameras (DSC-700L, DSC-932L, DSC-942L, DSC-5020L)
  • MiLight
  • XiaoMi Universal IR Remote Controller
  • WeMo Switch/Motion sensor
  • Amazon echo
  • Server(ubuntu16.04) or Raspberry pi 3 (Not tested yet)
  • Apple TV(4th gen) or iPad running as HomeKit hub

Usage

start homebridge container

docker run \
  --net=host \
  --name=homebridge \
  -e PUID=<UID> -e PGID=<GID> \
  -e TZ=<timezone> \
  -v </path/to/config>:/homebridge \
  kenhuang/docker-homebridge

Example:  
docker run \
  --net=host \
  --name=homebridge \
  -e PUID=1000 -e PGID=1000 \
  -e TZ=Pacific/Auckland \
  -v /homebridge:/homebridge \
  kenhuang/docker-homebridge

check homebridge container logs

docker logs -f homebridge

run command in homebridge container

docker exec -it homebridge sh

Configuration

Example config

sample-config.json

Alexa

Say "Alexa discovery devices" after start up the container, it should expose all the lights as Alexa supported devices

  • Alexa, turn on the _______
  • Alexa, turn off the _______
  • Alexa, set ______ to number percent

Siri

  • Hey Siri, set Office Aircon to Off
  • Hey Siri, set Office Aircon to Cool
  • Hey Siri, set Office Aircon to ______ degree
  • Hey Siri, turn on the ______
  • Hey Siri, set ______ to number percent

Trigger DoorBell

curl -X POST -d 'ding=dong&dong=ding' https://HOME_BRIDGE_IP:5005

MI IR Remote

for ChuangmiIRPlatform, you will need to find out the following information

  • MIIO_TOKEN

    execute the following command inside the container to find out miio token

    docker exec -it homebridge sh
    miio --discover
  • MI_LEARNED_CODE

    trigger MiLean switch on iOS then watch the container log to find out the IR command

Camera

Check tested camera configuration here: https://github.com/KhaosT/homebridge-camera-ffmpeg/wiki/Tested-Configuration

HomeKit Hub

  • Make sure enable iCloud two factor authentication
  • Turn off auto sleep for the HomeKit Hub device

About

Homebridge Docker. HomeKit support for the impatient using Docker on x86_64 or Raspberry Pi (armhf).

Resources

Stars

Watchers

Forks

Packages

No packages published