MirrorNest
← All guides

openHAB

openHAB is a vendor-neutral, technology-agnostic home automation platform that ties together diverse smart-home devices and protocols; its officially maintained Docker image is the most portable way to run it.

Target: Any Docker hostHome AutomationOfficial homepage ↗Official docs ↗
This guide is synthesized from openHAB's own official documentation, linked above — always cross-check exact package/version names there before running these commands on a production server, since distro and project versions move over time.

  1. 1Create host directories for persistent data

    mkdir -p /opt/openhab/conf /opt/openhab/userdata /opt/openhab/addons

  2. 2Run the openHAB container

    docker run --name openhab --net=host -v /etc/localtime:/etc/localtime:ro -v /etc/timezone:/etc/timezone:ro -v /opt/openhab/conf:/openhab/conf -v /opt/openhab/userdata:/openhab/userdata -v /opt/openhab/addons:/openhab/addons -d -e USER_ID=1000 -e GROUP_ID=1000 -e CRYPTO_POLICY=unlimited --restart=always openhab/openhab:5.0.0-debian

    Host networking is required for UPnP/mDNS device discovery. Replace USER_ID/GROUP_ID with IDs matching your host user.

  3. 3First login

    Open the web UI to run the setup wizard and choose your package profile (Simple, Standard, or Expert).

    Default ports: 8080 (HTTP) and 8443 (HTTPS).