DockerKit

Control your Docker Containers with HomeKit.

Requirements

NodeJS & npm / yarn

Use with Docker

You can now pull this image from Docker Hub and run it via Docker. Make sure to set net=host. Otherwise the devices won't be announced correctly.

Configuration

A very basic configuration is located in the config.example.json in the Repositories root-directory.

{
  "dockerode": {
    <configuration for docker connector. head over to https://www.npmjs.com/package/dockerode for more info. If empty it uses the /var/run/docker.sock>
  },
  "containerNames": [
    <add some container names here and only them will be published as a homekit device. if this is empty, every container will be publishes>
  ],
  "bridge": {
    "deviceName": "The HomeKit Bridge Name. You can use $hostname as a variable for the device's hostname. This does not work everytime. If you can't find the bridge use a normal name like Docker",
    "mac": "Some MAC Address for the Bridge. If you have multiple DockerKit Instances, they need different MACs",
    "port": 50045,
    "pincode": "Setup PinCode. XXX-XX-XXX, numbers only"
  }
}

Installation

Clone this repo git clone https://github.com/dunklesToast/DockerKit.git
Go into it cd DockerKit
Install Dependencies npm install or yarn
Move the config.example.json to config.json
Start the Service node src/DockerKit

Then go into the HomeKit App on your mobile Device (Mac does not work for pairing) and add a new Accessory. The default Setup Code is 123-45-678

Docker

Mount your own config file over /app/config.json (-v ./config.json:/app/config.json)
The Docker container must be in host networking mode in order to added as an accessory
The Docker socket needs to be exposed via TCP socket or volume mounted (-v /var/run/docker.sock:/var/run/docker.sock).

Host networking will not work in Windows or OSX due to docker running in a VM on those platforms.

An example docker-compose file is included.

Todo:

~~Fix 304 on first update~~
~~Enable a mode where every container is controllable~~
~~Create~~ and publish Docker Container for this module
Create a dimmable Light for Docker Swarm (idea by u/DuffMaaaann)
Basic Server statistics (idea by u/DuffMaaaann)
Fix issue with hostnames as Bridge Name

Any cool ideas for this project?

Create an Issue or Pull Request ^^

dunklesToast/DockerKit