16 January 2026

Home Assistant add Matter support and devices

As I run Home Assistant in a LXC using Portainer, I couldn't just install the python-matter-server through Add-Ons. Here are the steps that I used to get it installed.


Create python-matter-server in Portainer

  • Create a Volume
    • Portainer -> Volumes -> Add volume
    • matter_config
  • Create a Container
    • Image
      • ghcr.io/home-assistant-libs/python-matter-server:stable
    • Advanced container settings
      • Commands & logging
        • We want to override the listen address to allow only local connections from Home Assistant
        • Command: --storage-path /data --paa-root-cert-dir /data/credentials --listen-address=127.0.0.1
      • Volumes
        • /data -> matter_config
      • Network
        • Network -> host
      • Restart policy
        • Restart Policy -> Unless stopped
    • Click "Deploy the container"


Add Matter integration to Home Assistant

  • Settings -> Devices & services
    • Add integration
      • Matter
      • Since they are on the same host, use the default address


Adding Matter Devices

  • Install the Home Assistant App on your phone
  • Login
  • Make sure your phone is on the WiFi that you want the matter device on (eg. your IOT network)
  • Follow these steps in the App:
    • Hamburger menu
    • Devices & services
    • Matter
    • Add Device
    • No, It's new
    • Scan the QR code on the device
    • Follow the steps

Appendix

Sources




No comments:

Post a Comment