Manage cookies

We use cookies to improve our services. Read more about how we use cookies and how you can refuse them.

The necessary cookies help to make the website work properly.

Anonymous statistical cookies help to understand how visitors use the website.

  • Home Automation, Raspberry Pi
    5 min | 25865

    #Raspberry Pi: Xiaomi Sensors & Home Assistant (

    Home Automation, Raspberry Pi | 5 min | 25865

    Last week, I published an article about using Xiaomi sensors without a Xiaomi Gateway. The gateway/hub can be replaced with a Raspberry Pi and a USB-ZigBee dongle. You find the instructions here: #ZigBee: Xiaomi Sensors using Raspberry Pi (without Gateway!).

    As you can read in that article, two repositories are available to connect and process the data from the Xiaomi sensors. Additionally, Zigbee2mqtt can be connected to Well, I didn't want to use HassOS (the OS on which runs), but I wanted to use running on Raspbian, otherwise with Home Assistant running as an application, the add-ons were not available as in (Docker based) and I didn't get the possibility to run the hassio-zigbee2mqtt official container.

    The following command doesn't help:

    docker run -d --name="home-assistant" -v /home/pi/homeassistant:/config -v /etc/localtime:/etc/localtime:ro --net=host homeassistant/raspberrypi3-homeassistant

    because it deploys a container in which the Home Assistant application runs, but the functionabilities are not available.

    Then, I looked for the installation scripts and I found a way to run on Raspbian (if you are a Home Assistant expert and you know the right name for "this type of running" of Home Assistant, please leave me a comment).

    This is what I will try to accomplish in this tutorial:

    1. Install Docker on Raspberry PI
    2. Install/Deploy on Raspbian
    3. Install the Mosquito broker and the zigbee2mqtt add-ons
    4. Pair all the Xiaomi devices

    Installing Docker

    First, if you've not install Docker, you need to type and run the following:

    curl -sSL | sh
    sudo usermod -aG docker pi

    After executing the usermod line, reboot the Raspberry to get the pi user added to the docker group. Otherwise, you need to always use sudo every time that you use the docker command.

    More information about Docker on embedded systems is available here.

    Home Assistant dockerized ( on Raspbian)

    The following deploys Home Assistant dockerized. Actually, it creates a service that deploys the hassio-supervisor container, which then pulls and runs the raspberrypi3-homeassistant container.

    sudo apt-get update
    sudo apt-get install -y apparmor-utils apt-transport-https avahi-daemon ca-certificates curl dbus jq network-manager socat software-properties-common
    # older versions
    wget ""
    chmod +x
    sudo ./ -m raspberrypi3
    # newer repository (from 2020 onwards)
    curl -Lo
    bash --machine raspberrypi3

    The first container launched is, as I mentioned, armhf-hassio-supervisor. This pulls and deploys the raspberrypi3-homeassistant container (because of the option -m raspberrypi3).

    You can also deploy to see how the containers run:

    docker volume create portainer_data
    docker run -d -p 9000:9000 --restart unless-stopped -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer

    If you need to update the version, just type the following on a terminal/console:

    sudo docker pull homeassistant/raspberrypi3-homeassistant:latest
    systemctl start hassio-supervisor.service
    sudo reboot

    If it does not work, you need to kill the running homeassistant container. To do that, list the running containers using docker ps and look for the CONTAINER ID of the container with IMAGE name "homeassistant/raspberrypi3-homeassistant", then type docker kill <<the container id/hash>>. Then, reboot the system. If you've installed, just select the container and click on the Kill button.

    Installing Zigbee2mqtt

    After running the file, you can access Home Assistant pointing to http://<ip-address>:8123. Home Assistant will ask you to set up a username and password as usual.

    Then, follow these steps to pair the Xiaomi sensors:

    1. Go to and add the as repository (see Fig. 1).
    2. Look for the Mosquitto broker add-on and install it.
    3. Set the configuration to the following (I added login credentials to the MQTT broker. Alternative, you can set anonymous to true) and start the add-on:
      "logins": [
      "anonymous": false,
      "customize": {
      "active": false,
      "folder": "mosquitto"
      "certfile": "fullchain.pem",
      "keyfile": "privkey.pem",
      "require_certificate": false
    4. Then, look for the zigbee2mqtt add-on and install it (see Fig. 2).
    5. Set the configuration (add the login credentials - more options are available here) to the following and start the add-on (the default options have an error, the password key should be password and not pass!):
      "data_path": "/share/zigbee2mqtt",
      "devices": "devices.yaml",
      "groups": "groups.yaml",
      "homeassistant": true,
      "permit_join": false,
      "mqtt": {
      "base_topic": "zigbee2mqtt",
      "server": "mqtt://<ip-address>:1883",
      "user": "yourusername",
      "password": "yourpassword"

      You need to have the USB-ZigBee dongle connected before you start the add-on. The permit_join option should be set to true to pair the ZigBee sensors. Once you joined all devices, set permit_join to false for security reasons. Every time you change a setting, you need to restart the add-on.

    6. Go to Configuration->Integrations, and configure the MQTT add-on selecting the Enable discovery option (see Fig. 3).
    7. Press the link/reset button on the Xiaomi sensors to pair and discover them.
    8. Once a device is discovered, you can change the device_id with a friendly name using the web interface: Go to Configuration->Entity Registry to do that (see Fig. 4).
    9. The sensors should be available on the Overview page as in Fig. 5.
    10. Once you joined all devices, do not forget to set the permit_join variable to false! and restart the add-on.

    If you want to stop everything, you need to type the following:

    sudo systemctl stop hassio-supervisor.service

    This stops the armhf-hassio-supervisor container and then you can stop all the other running containers. Otherwise, the containers will start automatically after you stop them.

    To start the service again, type the following:

    sudo systemctl start hassio-supervisor.service
    Fig. 1: running on Raspbian
    Fig. 2: zigbee2mqtt: installation dialog
    Fig. 3: MQTT configuration: Enable discovery mode option
    Fig. 4: Entity Registry: Changing the Entity ID with a friendly name
    Fig. 5: Overview page: Checking sensor status from the web interface

    Additional information and credits


    This is an extension to the #ZigBee: Xiaomi Sensors using Raspberry Pi (without Gateway!) article. In this article, I integrate the Xiaomi sensors to Home Assistant without any Xiaomi gateway, cloud or smartphone application. There is also no need to install HassOS, and it was possible to run on Raspbian. If you are curious and you want to see how many containers are running, check Fig. 6!

    Fig. 6: Portainer: Overview of the running Docker containers