Documentation
TutorialsCommunity
  1. ALPON
  2. Tutorials

Deploying OpenHAB

Deploy openHAB as a container on ALPON X5 AI or ALPON X4 through ALPON Cloud: pull the image, push it to the Sixfab Container Registry (or use Docker Hub), configure the addons, conf and userdata volumes with Host Network, and open the dashboard on port 8080.

Deploy openHAB on ALPON

Run openHAB as a container on your ALPON X5 AI or ALPON X4 and integrate the devices and systems in your home from one platform. This guide deploys the official image through ALPON Cloud, mounts persistent addons, configuration and userdata directories, and opens the dashboard on port 8080.

ALPON X5 AI ALPON X4 openHAB Smart home
ALPON · Tutorial · Containers · Home automation
How do I deploy openHAB on ALPON?

Push the openhab/openhab image to your Sixfab Container Registry (or deploy it straight from Docker Hub), then use the Applications → Deploy panel on ALPON Cloud to launch the container on your ALPON X5 AI or ALPON X4 with the /openhab/addons, /openhab/conf and /openhab/userdata volumes and Host Network enabled. Open http://<DEVICE_IP>:8080 in a browser to reach the openHAB dashboard.

Overview

openHAB is a flexible open-source home automation platform that integrates various devices and systems for smart home functionality. Running it as a container on an ALPON X5 AI or ALPON X4 keeps the automation local, lets you manage and update your openHAB instance through ALPON Cloud, and ensures compatibility with the device's architecture.

The steps below are identical on ALPON X4 and ALPON X5 AI. For advanced configurations, extensions, or troubleshooting, refer to the official openHAB documentation.

Before you start

You need an ALPON X5 AI or ALPON X4 registered on ALPON Cloud, and Docker installed on your build machine to pull and push the image. New to container deployment? Start with Containerize Apps for ALPON.

  1. 1

    Add the openHAB container

    Make sure the openhab/openhab image is available to your device. The recommended path is to push it to your Sixfab Container Registry so deployments are fast and work offline. From your build machine, pull the arm64 image:

    bash · pull the image 
    docker pull --platform linux/arm64 openhab/openhab:4.2.2

    Then log in to Sixfab Registry, click + Add Container, and follow the prompts to push the image.

    Pushing images to the Sixfab Container Registry

    For the full walkthrough of tagging and pushing an image, see Update Containers from the Sixfab Container Registry.

    Alternative: deploy straight from Docker Hub

    If you prefer not to use the Sixfab Container Registry, choose “I would like to use my own container path” during deployment and enter openhab/openhab:4.2.2. The container is then pulled directly from Docker Hub (the device needs internet access at deploy time).

  2. 2

    Deploy the container on ALPON

    Open your device in ALPON Cloud, go to the Applications section, and click + Deploy. In the Deploy Container window, use these settings:

    Container Name openhab
    Image The openHAB image and tag you pushed to the Sixfab Container Registry — or, using the alternative option, openhab/openhab:4.2.2.
    Volumes Click + Add More and add the five volumes in the table below.
    Enable Host Network Turn this on so openHAB can discover and talk to devices on the local network.
    Read/WriteLocal PathTarget Path
    Read/Write/etc/localtime/etc/localtime
    Read/Write/etc/timezone/etc/timezone
    Read/Write/home/alpon/openhab_addons/openhab/addons
    Read/Write/home/alpon/openhab_conf/openhab/conf
    Read/Write/home/alpon/openhab_userdata/openhab/userdata
    Where the data lives

    The /home/alpon/openhab_addons, /home/alpon/openhab_conf and /home/alpon/openhab_userdata directories on the device hold openHAB’s add-ons, configuration and runtime data, so they survive a container restart or update; the two time-zone mounts keep the container’s clock aligned with the device.

    Click + Deploy to launch openHAB on the device.

  3. 3

    Open the openHAB dashboard

    Once the deployment finishes, find the device's local IP address under Asset Details → Network tab → Interface Monitoring → Details, then open the dashboard in a browser:

    browser · openHAB dashboard 
    http://<DEVICE_IP>:8080

    The openHAB setup page should load. If it doesn't, confirm the container is running in the Applications section and that Host Network was enabled in step 2.

Ready when…
  • The openhab container shows as running in the Applications section.
  • The dashboard loads at http://<DEVICE_IP>:8080.
  • Changes you make under /home/alpon/openhab_conf survive a container restart.

openHAB is now running on the ALPON. Complete the initial setup in the dashboard, then add your bindings and things from the openHAB settings.

Production image policy: Replace floating :latest references with a reviewed immutable tag or digest, then record the selected version for rollback.

Continue exploring

Related guides

Build on this workflow with deployment, fleet-management, and hardware guidance for the ALPON platform.

Workflow Deploy Applications on ALPON Push an ARM64 image, configure its runtime, and launch it from ALPON Cloud. Open guide Platform ALPON Cloud Manage devices, applications, connectivity, and remote operations from one workspace. Open guide Hardware Compare ALPON devices Compare ALPON X4 and ALPON X5 AI capabilities for your edge workload. Open guide

Updated 8 days ago

Did this page help you?