Deploying Home Assistant

Overview

Home Assistant is a free, open-source home automation platform that controls and manages smart devices — lights, thermostats, sensors, media players — from a single place. Running it as a container on an ALPON X5 AI or ALPON X4 keeps the automation local: the device sits on the same network as your equipment, works without a cloud round-trip, and stays manageable through ALPON Cloud.

The steps below are identical on ALPON X4 and ALPON X5 AI. For advanced configuration, integrations, and add-ons, see the official Home Assistant documentation.

1. 1

   Add the Home Assistant container

   Make sure the homeassistant/home-assistant 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 homeassistant/home-assistant:latest

   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 homeassistant/home-assistant:latest. 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 homeassistant

   Image The Home Assistant image and tag you pushed to the Sixfab Container Registry — or, using the alternative option, homeassistant/home-assistant:latest.

   Volumes Click + Add More and add the three volumes in the table below.

   Enable Host Network Turn this on so Home Assistant can discover and talk to devices on the local network.

   Read/Write	Local Path	Target Path
   Read Only	/etc/localtime	/etc/localtime
   Read Only	/etc/timezone	/etc/timezone
   Read/Write	/tmp/config	/config

   Where the configuration lives

   The /tmp/config directory on the device stores Home Assistant’s settings. Create or edit configuration.yaml there to customize your setup; the two time-zone mounts keep the container’s clock aligned with the device.

   

   Click + Deploy to launch Home Assistant on the device.

3. 3

   Open the Home Assistant 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 · Home Assistant dashboard

   http://<DEVICE_IP>:8123

   

   Home Assistant’s onboarding wizard should load. If it doesn't, confirm the container is running in the Applications section and that Host Network was enabled in step 2.

The Deploy Container window in ALPON Cloud with the volumes and Host Network configured.

Home Assistant’s onboarding screen served from the ALPON device.