selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitHub
ConBee II logo

Self-host ConBee II

Docker image for deCONZ Zigbee gateway with Phoscon UI

ReleaseOpen SourceMIT
Docker ComposeCompose file & guide
docker compose up -d
Updated3 months ago
LanguageShell
Setup difficultyModerate
Stars
396
Ports
80 (HTTP UI and REST API), 443 (WebSocket API), 5900 (VNC), 6080 (noVNC)
Docker
deconzcommunity/deconz
ConBee II screenshot 1ConBee II screenshot 2ConBee II screenshot 3ConBee II screenshot 4ConBee II screenshot 5

What is ConBee II?

This Docker image packages deCONZ to run a Zigbee gateway with ConBee and RaspBee USB adapters. It provides the Phoscon web interface for managing devices, REST and WebSocket APIs for external integration, and optional VNC or noVNC access to view the mesh network. The image supports amd64, arm/v7, and arm64 platforms. All settings are controlled through environment variables covering device paths, port numbers, baud rates, and debug flags. Deployment uses Docker or Docker Compose.

Should you self-host ConBee II?

ConBee II scores 51/100 on selfhost.directory (how scoring works) and ranks #61 of 104 in Home Automation. It has 396 GitHub stars.

There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is MIT-licensed and written mostly in Shell.

Its closest alternative on selfhost.directory is Home Assistant (91/100, 91 795 stars). It scores higher overall, so compare the two before you pick. See ConBee II vs Home Assistant side by side.

Features

  • Alexa integrationRequires DECONZ_WS_PORT=8443 with matching port mapping
  • Auto device detection
  • ConBee III support
  • Firmware update support
  • Phoscon Web UI
  • RaspBee II support
  • REST API
  • VNC/noVNC mesh visualization
  • WebSocket API

ConBee II README

How to install ConBee II

Install ConBee II with Docker Compose

Environment variables
TZ, DECONZ_DEVICE, DECONZ_WEB_PORT, DECONZ_WS_PORT, DECONZ_BAUDRATE, and many others
  1. Copy docker-compose.yml from this repository to your host.
  2. Edit the compose file and set at least the following values:
    • TZ to your local timezone (for correct scheduling and logs)
    • DECONZ_DEVICE to your adapter path (for example /dev/ttyACM0)
    • the data volume path (for example /opt/deconz:/opt/deCONZ)
  3. Pull and start the container:
docker compose pull
docker compose up -d
  1. Open Phoscon in your browser: http://<host-ip>:<DECONZ_WEB_PORT>.

Recommended for production use

How to configure ConBee II

  • DEBUG_APS0deCONZ --dbg-aps flag

    deCONZ --dbg-aps flag

    values: 0, 1

  • DEBUG_DDF0deCONZ --dbg-ddf flag

    deCONZ --dbg-ddf flag

    values: 0, 1

  • DEBUG_DEV0deCONZ --dbg-dev flag

    deCONZ --dbg-dev flag

    values: 0, 1

  • DEBUG_ERROR0deCONZ --dbg-error flag

    deCONZ --dbg-error flag

    values: 0, 1

  • DEBUG_HTTP0deCONZ --dbg-http flag

    deCONZ --dbg-http flag

    values: 0, 1

  • DEBUG_INFO1deCONZ --dbg-info flag

    deCONZ --dbg-info flag

    values: 0, 1

  • DEBUG_OTA0deCONZ --dbg-ota flag

    deCONZ --dbg-ota flag

    values: 0, 1

  • DEBUG_ZCL0deCONZ --dbg-zcl flag

    deCONZ --dbg-zcl flag

    values: 0, 1

  • DEBUG_ZDP0deCONZ --dbg-zdp flag

    deCONZ --dbg-zdp flag

    values: 0, 1

  • DECONZ_APPDATA_DIR/opt/deCONZApp data directory

    App data directory

  • DECONZ_BAUDRATE0Adapter baud rate

    Adapter baud rate

    values: 115200 for ConBee III, 38400 for RaspBee II

  • DECONZ_DEVICEautoExplicit ZigBee adapter path

    Explicit ZigBee adapter path

    values: /dev/ttyUSB0, /dev/ttyACM0, /dev/ttyAMA0, /dev/ttyS0

  • DECONZ_DEV_TEST_MANAGED0deCONZ --dev-test-managed flag

    deCONZ --dev-test-managed flag

    values: 0, 1

  • DECONZ_GID1000GID for data permissions

    GID for data permissions

  • DECONZ_NOVNC_PORT6080noVNC port (0 disables)

    noVNC port (0 disables)

  • DECONZ_START_VERBOSE0Enable start-script debug logging

    Enable start-script debug logging

    values: 0, 1

  • DECONZ_UID1000UID for data permissions

    UID for data permissions

  • DECONZ_UPNP1Enable UPnP (0 to disable)

    Enable UPnP (0 to disable)

    values: 0, 1

  • DECONZ_VNC_DISABLE_PASSWORD0Disable VNC auth (trusted networks only)

    Disable VNC auth (trusted networks only)

    values: 0, 1

  • DECONZ_VNC_MODE0Enable VNC mode

    Enable VNC mode

    values: 0, 1

  • DECONZ_VNC_PASSWORDchangemeVNC password

    VNC password

  • DECONZ_VNC_PASSWORD_FILE0Read VNC password from file

    Read VNC password from file

    values: 0, 1

  • DECONZ_VNC_PORT5900VNC port

    VNC port

  • DECONZ_WEB_PORT80HTTP UI and REST API port

    HTTP UI and REST API port

  • DECONZ_WEBS_PORT0HTTPS UI port (0 disables)

    HTTPS UI port (0 disables)

  • DECONZ_WS_PORT443WebSocket port

    WebSocket port

  • NON_ROOT0Run as deconz user (0) or root (1)

    Run as deconz user (0) or root (1)

    values: 0, 1

  • TZContainer timezone

    Container timezone

    values: e.g. Europe/Berlin

More in IoT

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…