Prerequisites
Your Home Assistant Podman container must run in host network mode (--network host or network_mode: host) so that BACnet/IP UDP broadcasts on port 47808 can reach the container.
Step 1: Install HACS inside the container
- Run the official HACS installation script directly inside your running Home Assistant container (adjust the container name
homeassistantif yours is different):
podman exec -it homeassistant bash -c "wget -O - https://get.hacs.xyz | bash -"
- Restart the container so Home Assistant registers HACS on the file system:
podman restart homeassistant
- Enable HACS in Home Assistant:
- Open HA in your browser ➔ Settings ➔ Devices & Services ➔ Add Integration.
- Search for HACS and select it.
- Accept the prompts and complete the setup via your GitHub account.
Step 2: Download the BACnet repository in HACS
- Open HACS from the Home Assistant sidebar.
- Click the three dots (⋮) in the top right corner ➔ Custom repositories.
- Enter the repository details:
- Repository URL:
[https://github.com/CervezaStallone/Home-Assistant-BACnet-integration](https://github.com/CervezaStallone/Home-Assistant-BACnet-integration) - Category:
Integration
- Click Add, then click Download.
Important: Do not try to configure the integration under Settings yet, or you will trigger the
500 Internal Server Error!
Step 3: Manually install Python packages (BEFORE restarting!)
Install the exact Python dependencies required by the integration directly into the container’s Python environment:
podman exec -it homeassistant pip install BAC0 bacpypes BACpypes3==0.0.99
Step 4: Restart the container
Only after the pip install command has completed successfully, restart Home Assistant so the Python runtime loads the new packages during boot:
podman restart homeassistant
Step 5: Configure the BACnet/IP integration
- Go to Settings ➔ Devices & Services ➔ Add Integration.
- Search for BACnet IP. The setup dialog (Config Flow) will now open smoothly without errors.
- Enter your network settings:
- Interface / IP: e.g.,
192.168.1.X/24 - Port:
47808(Default BACnet UDP port) - Device ID: A unique BACnet Device ID for Home Assistant (e.g.,
1234)
Note on Container Updates: When updating your Home Assistant Podman image (
podman pull), the container layer is recreated. After upgrading the HA container, simply re-run Step 3 (pip install ...) and restart the container if HA asks for the dependencies again.
Disclaimer / Disclosure: I received this hardware as a sponsored unit. For those looking to buy one, it is currently available (at least in Germany) through major electrical wholesalers (Elektrogroßhändler).
Feel free to ask any questions regarding the container setup, the hardware, or the BacNet configuration below!
