Enabling UI with Docker

Homebridge Config UI X is supported by the oznu/homebridge docker image.

To enable Homebridge Config UI X start the container with the HOMEBRIDGE_CONFIG_UI=1 environment variable.

This plugin will run as seperate process to Homebridge when using Docker. This allows you to still access the web interface even if Homebridge is failing to start due to a config or plugin problem. For this reason you do not need to (and should not) add homebridge-config-ui-x related config to your config.json when using this plugin with docker.

Example:

docker run --name=homebridge --net=host -e HOMEBRIDGE_CONFIG_UI=1 oznu/homebridge

Docker Compose Example:

version: '2'
services:
  homebridge:
    image: oznu/homebridge:latest # use "raspberry-pi" instead of "latest" for arm devices
    restart: always
    network_mode: host
    volumes:
      - ./config:/homebridge
    environment:
      - PGID=1000
      - PUID=1000
      - HOMEBRIDGE_CONFIG_UI=1
      - HOMEBRIDGE_CONFIG_UI_PORT=8080