HassOS/HassIO 极简安装小米体脂秤中文版，支持 Home Assistant; OpenWrt 的docker环境安装HassIO，支持斐讯N1的OpenWrt。 Home Assistant 之OpenWrt设备追踪，连接路由器显示在家离家状态。 Home Assistant接入小米蓝牙温湿度传感器2; 利用ESP-01/01S.ESPHOME固件，通过HA控制RGB灯泡。.
- 【课时28】 Docker基础-下(高级用户) （05:19） 章节6 公网访问篇 【课时29】 使用hassio插件配置域名与证书(1) （09:24） 【课时30】 使用hassio插件配置域名与证书(2) （08:14） 【课时31】 申请Amazon免费云主机 （07:19） 【课时32】 HASSIO插件—tunnel2local以及frp服务搭建 （13.
- Okay, details here is how I run Home Assistant on Docker on a Raspberry Pi 4. Install Raspbian on the Raspberry Pi 4. Install Docker and Docker-Compose. Create /root/docker-compose.yml consisting of the following (NOTE: I use the Aeon z-wave stick at /dev/ttyACM0).
11/25/2019
I recently started a small home automation project without any prior knowledge about Home Assistant or the other components. So I was a complete newbie and had to tackle multiple challenges along the way. If you are in the same position, this guide is for you!
- Installation of Home Assistant
- Set up Xiaomi Aqara devices with deCONZ
- Setting up the Xiaofang Camera
- Troubleshooting
- Fun things to try out
Hardware needed
I chose the following components:
- Raspberry Pi 3B+ (amazon.com(opens new window)*)
- Conbee II(opens new window) stick as Zigbee Gateway together with deCONZ gateway add-on (amazon.com(opens new window)*)
- SD-Card of type A2 for better I/O performance (amazon.com(opens new window)*)
- Home Assistant via Hass.io(opens new window) image
- Xiaomi Aqara sensors acquired via Aliexpress(opens new window) (door sensor, temperature/humidity/pressure sensor, smart plug)
- Xiaomi Xiaofang Dafang Camera 1S IP T20L Chip (Aliexpress(opens new window))
- A 512 MB SD-Card for the camera
Installation of Home Assistant
Important: If you plan a long-term usage of Home Assistant you might want to consider to install it on an SSD instead using the SD card. Many users have reported that their SD cards suddenly stopped working and they had to re-install everything. This happened to me as well. And I switched to an SSD afterwards (see chapter below). The installation is a bit more technical than using the SD card. So depending on your goals and technical abilities you might want to choose either the SD card way or SSD way.
Lets start with the installation on an SD card!
Installation was straight forward. I basically followed the official installation(opens new window).
I downloaded the recommended 'Raspberry Pi 3 Model B and B+ 32bit' image flashed the SD card using balenaEtcher.(opens new window) At the time of writing (June 2019) this was HassOS 2.12 and v0.94.3 of Home Assistant.
I connected the Raspberry to my local network (via cable) and booted it up without attaching the Conbee II stick yet (you will later see why). I found the IP of the device in my Router but I could also open it via http://hassio.local:8123/
To make it work via Wifi as well, you need to do the following (official how-to here(opens new window)) as there is no option to add your Wifi credentials via the Web UI (which I find strange, but hey, why make it easy if there is a complicated way 😃
- Get an old USB stick and make sure its formatted with FAT32 (I am looking at you macOS!).
- Remove all files which are on it.
- Rename the stick to 'CONFIG'
- Create a directory called 'network'
- Create a file in this directory called 'my-network' (no extension!). This file needs to get the content shown below
- Replace ###CHANGE-THIS### with the name of your Wife-Network and your password.
- Put the stick in your powerless Raspberry Pi and bring it back up (boot it). It should now show up in your Wifi-Network and again you can connect to it. You can now unplug the stick.
Initial setup
Now since everything is up and running its time to add the Conbee II stick to the mix. Without having it attached to your Pi go to Hass.io > System and press the 'Hardware' button. Under 'serial' you might see an entry like this: '/dev/ttyAMA0'. Write it down. Now connect the Conbee II stick to the Pi and boot it up again. Just click on 'Reboot' in the same card. This can take some while.
In newer versions of Home Assistant you will find the 'Hardware' section here:
Once the Pi is back go to the same place and check the Hardware section again. Under 'serial' there should be a new component, e.g. called '/dev/ttyACM0'. This is our friend the Conbee II stick! Copy this string to the clipboard.
Setting up deCONZ
Now go to Hass.io > Add-on store and install the deCONZ add-on. Now at the bottom of the page there is a config section. Add the name of your device like this:
Now you can start this add-on. If everything goes right a green light should pop-up. Click on 'Open web UI' and a new tab should open with the Phoscon Gateway. You might need to set a password. Set it and remember it. You will need it every time you open up this gateway.
After you installed the add-on you also need to install the deCONZ integration. To connect the integration to the add-on you need grant access to it via this option:
Later I will show you how to add your first sensors.
Setting up the Configurator
You also want to set up another add-on which is called Configurator(opens new window). This add-on allows you to manually edit all your config files from within your browser.
Setting up the iOS app
Before we add our devices we should set up everything so you can use the Home Assistant mobile app(opens new window) on your iPhone which helps for device or presence tracking.
Go to Configuration > Integrations and install the 'Home Assistant iOS' integration. This will also make the notification integration as well as the device tracking component available. This installation even happens automatically if you have discovery mode enabled and start the app for the first time.
Your integrations page now should look somewhat like this:
Now download the app(opens new window) and install it. On first load it should already find your HA installation. Choose it and complete the config, e.g. entering your user credentials. Also choose the data you would like to share with HA and your notification preferences. Update your status by pressing the 'Up-Arrow' icon on the lower left. Now your data should become visible on your home screen.
In a next step you need to link the new device to your user. To do this, go to Configuration > Persons and choose your name. Under 'Track device' choose the new device from the list.
Set up Xiaomi Aqara devices with deCONZ
Setting up the sensors
Now lets start with adding some real sensors. We will start with a door sensor. To do that unpack your sensor and open the Web UI (named 'Phoscon') of the deCONZ add-on. You can open the deCONZ Web UI by going to 'Hass.io > Add-on store' and clicking on the 'deCONZ' add-on. Now on the next page click on 'Open Web UI'.
A new browser tab will open showing your gateway. Select the gateway by clicking on it. In my case the gateway name is 'Phoscon-GW'.
Phoscon wants you to add some lights but we do not have any lights (yet). You can skip this step. Feel free to add a group if you want to. I created a group called 'Living Room'. Now open the 'hamburger menu' and choose the 'Sensors' option here:
On the next page click on 'Add new sensor' and choose 'Other' in the upcoming modal. Now Phoscon is searching for new sensors.
Take one of your sensors and press the small button for some seconds until it starts to blink blue. Then release the button and wait a bit.
After another approx. 10 seconds Phoscon has found the device and confirms it with 'Sensor ready'.
Its as easy as that. Now click 'Ready' and check the list of connected sensors. The new sensor should show up here.
You can also test your new sensor right here. If its a door sensor just bring the two parts together. The status in the 'Values' column updates real-time. Cool? Cool!
You can click on each sensor and rename it if you want (click on the pencil icon on the next page after clicking on it).
Now go back to the Home Assistant overview page and open 'Configuration > Integrations > deCONZ Zigbee Gateway' (the last name may be different depending on your setup).
You can find your sensor automatically here as well. You can rename it here as well and assign it to one of your existing areas.
Another option is to open 'Configuration > Entity registry'. You should find your new sensor there as well.
I had no issues installing the following sensors this way:
- Xiaomi Aqara door sensor
- Xiaomi Aqara temperature / humidity / air pressure sensor
- Xiaomi Aqara water leak sensor
- Xiaomi Aqara smart plug
Setting up the Xiaofang Camera
I also bought 2 of these cameras (see link above). The challenge with these cameras is, that you cannot use them out-of-the-box as you can do it with the sensors. You need to replace the current firmware with a new one. So here is my step-by-step approach:
Replacing the bootloader and the firmware
The installation (described here(opens new window)) happens in 2 steps. First you need to replace the bootloader. For the camera I used you need to use the 'Xiaomi XiaoFang T20' bootloader. It worked as described. I used a 512 MB SD-Card for this and formatted it on my Mac with FAT16 (FAT32 is recommended). Only challenge is you don't really know when the process is finished so I waited as described on this page and then continued.
Next you need to copy the new firmware(opens new window) onto the SD-Card. You can leave the bootloader binary file on the card if you want.
My file config/wpa_supplicant.conf looks like this:
You need to replace ### with your wifi settings. 'ssid' is the name of your wifi-network and 'psk' is the password one need to login.
Insert the card with the new firmware and the modified config file back into the camera and connect it with power. The camera now should show up in your wifi router and you can access it via https://dafang
Add the camera to Home Assistant
Now I added the camera to my configuration.yaml file. After some initial issues I chose this entry:
You need to adjust the IP address accordingly. Now you should be able add this camera to your homescreen. You can add a card of type 'Picture Entity' with the following content:
Now you should be able to see the current image of the camera
Setting up the MQTT Mosquitto broker
The camera communicates its status via the MQTT protocol, e.g. if there is motion detected. To get this information into Home Assistant you need to install a so called 'MQTT broker'. MQTT stands for 'Message Queuing Telemetry Transport'. Think of it like a post office which is able to retrieve and send messages from/to other devices.
To install a MQTT broker you need to install the Mosquitto broker via Hass.io. Just chose this add-on from the list of official add-ons.
Here is my config file:
As shown you should change the username and password.
I did not make any more changes to my configuration.yaml file.
Next you need to update the file /system/sdcard/config/mqtt.conf on the camera. This is also described here(opens new window).
Here is how my file looks like after the update:
Its important that you change all 'changethis' items with the settings you set in the Mosquitto broker config file and uncomment the AUTODISCOVERY_PREFIX line. Under HOST you add the ip address of the raspberry pi (just do a simple ping hassio.local to find out).
Reboot both HA and the camera. Now you should be able to start the 'mqtt-control' and the 'mqtt-status' services on the camera.
Now if you go to 'Configuration / Integrations' you should see the MQTT integration with all the status information from the camera.
You can now add these sensors and switches to your Overview panel, e.g. by adding this card:
I had the issue that the camera did not send any motion detection messages although everything seems to be configured correctly. I stumbled then across this proposal(opens new window) and adding a swapfile on the camera worked for me as well (July 2019).
Send photos to your slack channel
To get this up and running it took me a lot of time. In the mean time I signed up with the Nabu Casa(opens new window) service. This is what you should do anyway to support the development of this software. I did it because I started with iOS notifications and to send an attachment this attachment needs to be publicly accessible. I moved to slack later to get better image quality and I was using Slack anyway.
To get my feet wet I wanted to create an automation which sends me a picture to Slack (see below how to set up Slack notifications) when the vibration sensor on our cat flap triggers. Here is how the automation looks like:
To make this work you need to create a new folder called 'www' in your config folder. You can use the 'Configurator' add-on to do it:
All elements in this folder are now publicly accessible via the /local folder in the URL shown above.
Your first 'Hello world' automation and notification
To get your feet wet with automations and notifications lets add a simple notification which tells you that your smartphone gets charged. Before we start we need to get to know the ID of your smartphone. To find out, we can use the 'Configurator' add-on we installed earlier. Here open the .ios.conf file and look for your deviceId:
Hassio Docker Raspberry Pi 48
In my case its 'trutz1'.
(BTW: I changed my devices' name a couple of times within the app and suddenly got multiple appearances of sensors, devices and much more on the overview page. To get rid of all this I deleted the iOS integration and cleared the file known_devices.yaml. Then I re-installed the integration and everything was ok again. You might want to boot after each change.)
You should also check the name of your phone's sensors. To find those, go to Configuration > Entity registry. There you can find all your sensors incl. their internal id.
In our case its 'sensor.tkf_battery_state'. Having this information we can start our first automation which triggers a notification to our iPhone. Go to Configuration > Automation and create a new entry here using the following settings:
For the Trigger you choose the Type 'State' and then you select the sensor's name we found out earlier. For the values you enter 'Unplugged' for the 'From' property and 'Charging' for the 'To' property (You can find out the sensors' properties by clicking on them in your overview page).
For the Action you choose 'Call service' as the action type and for the service you use 'notify.ios_' + your deviceId. Then you need to pass a JSON object with a 'message' property. Make sure you are using quotes here.
Now save your first automation and lets test it bei either plugging your phone into the wall or trigger this automation manually. To do the latter just go back one page (don't forget to save) and press the info icon. In the modal you can trigger the automation.
A notification should now be displayed on your iPhone! Yay!
Congratulations! Now you have a working setup and you can start creating your own rules with Home Assistant.
Create backups and snapshots
I had to learn this the hard way so you don't have to. The SD card gets corrupted quickly. Nobody knows why but it happens. So please create 'Snapshots' after each major change and save them locally. Once your SD card becomes unreadable your snapshots stored on the card do not help much.
Another good idea is to push the whole /config directory to Github or your git provider of choice. This literally saved me one time. Use the secrets.yaml file to store your secrets and put it in your .gitignore file.
Installing Hass.io on a SSD
Important note: It seems that the developers of HA/hass.io have changed things on May 2020 (after this initial post was created). Please read the following blog posts:
My installation routine below does not work anymore as the script at https://raw.githubusercontent.com/home-assistant/hassio-installer/master/hassio_install.sh is not available anymore. Not sure, what the best way is currently. Will update this post next time I am updating my installation. Please stick with the official guide(opens new window) for the time being.
Before you start: If you have a running HA installation on your SD card and you would like to restore that on your SSD, then you need to create a 'Snapshot' and download it to your local computer. Also make a backup of your Zigbee gateway in the deCONZ web UI. You don't need it but you never know. Also backup other files you might need later.
After crashing my SDCard for the first time I ordered a cheap SSD (128 GB) for 20 EUR and a connector cable (SATA to USB3 for 9 EUR). You cannot use the hass.io images you use for the SD card, hass.io will not boot. You need to install hass.io as you would do on a generic Linux system. We will use Rasbian for that purpose. However the current version of Raspbian ('Buster') does not really work (as of July 2019). You need to use the earlier version called 'Stretch'. You can get it here:
I found this guide very helpful to enable SSH(opens new window) after flashing the SSD. It seems it is also possible to clone the SDCard(opens new window) but I did not test it. This process takes very long so I decided to go down the Raspian route.
After flashing the SSD you need to login to your Raspberry Pi:
or
Make sure you added your SSH key before. No change your settings (sudo raspi-config) and run the following commands:
This takes some time to complete. After this finished reboot the Pi, e.g. via
Now log back in and run the following commands:
Note that the last line is different to compared to the official guide(opens new window). Also 'add-apt-repository universe' does not apply to Debian based images. This is only needed for Ubuntu.
With 'docker ps' you should now be able to see the 'homeassistant/armv7-hassio-supervisor' container running. Now just wait until a second container called 'homeassistant/raspberrypi3-homeassistant' shows up. This can take some minutes. Now you need to wait again until Home Assistant got installed. This can can 20min as with the SD card. You can check the status via this URL: http://192.168.xxx.yyy:8123/ (adjust the IP accordingly) or http://raspberrypi.local:8123(opens new window).
To install your backup, install the 'Samba share' addon and adjust the config file for this addon, e.g. like this:
Change 'eth0' to 'wlan0' if you are connected via Wifi.
You can connect to this Samba share on the Mac via Finder / Connect with Server / 'cifs://raspberrypi.local'. Copy your local snapshot file to the /backup folder and re-install it via the Web UI of hass.io (I used the 'Restore Selected' option). This takes some minutes to complete. Now your old installation should be back up.
Done!
Troubleshooting
I had the issue that the Xiaomi sensors became unavailable after some hours. Here are some tricks you can do to avoid it:
Update the Conbee II firmware to the latest firmware version.
Within the Phoscon app go to 'Gateway' and check if an update is available. Create a backup before you update.
Conbee II connection
Attach the Conbee II stick not directly to the Raspberry Pi but use an extension cable. Some users reported that this helped with stability.
Check the Zigbee mesh
Hassio Docker Raspberry Pi 45
Zigbee is the network your items communicate on. Not all items might talk directly with your Conbee II gateway but with a repeater instead. Some lightbulbs act as a repeater to increase the range of your Zigbee network. Not all bulbs work very well within this network. You can check which item is connected by activating the deCONZ VNC server. Think of it as a remote monitor. To activate it, set a password and a port (5900 is recommended here) in the deCONZ add-on settings:
Don't forget to hit 'SAVE' in both boxes. Reboot the Pi if you cannot access the server. You now need a VNC-Viewer to access it via vnc://hassio.local:5900 If you are on MacOS you are lucky: The VNC viewer is built it. Just open this URL in the browser and off you go.
This is how the mesh view could look like (these are German friendly-names). The blue item is my Conbee II stick. All items talk directly with the stick in this scenario.
Check if there are other than green lines and try to remove unstable repeaters from your network.
Wifi interferences
If the pairing / connection issues come back, check this great article(opens new window) if you have an incompatible device / repeater in your network. More tipps are found in this thread(opens new window). And this post(opens new window) covers some issues coming from interferences with your 2.4 GHz wifi router.
Check the logs
Activate logging by adding this to your configuration.yaml file. You can use the 'Configurator' add-on to easily do it.
You can now check the log file e.g. via the 'Configurator' add-on (simply way) or log into your Pi via SSH (you need to activate the 'SSH server' add-on to do it) and monitor the live logs with 'tail -f home-assistant.log' on the console. More info about the Logger component here(opens new window).
Fun things to try out
Play audio files (MP3 / WAV) via Raspberry Pi
Install Hassio Docker Raspberry Pi 4
- Install and start the mopidy media play via this(opens new window) instruction. Don't forget to replace YOUR.HOST.IP with your internal IP.
- Create the folder /share/mopidy/media via ssh
- Add this folder to the mopidy add-on config settings (go to Hass.io > Dashboard > Mopidy Add-on), e.g. like this:
- Restart the home assistant server
- Download an audio file of your choice into this folder (/share/mopidy/media) via wget, e.g. you can use this one(opens new window).
- Open this URL in your browser: http://hassio.local:6680/iris/library/browse/local%3Adirectory%3Ftype%3Dtrack
- Find the file you just downloaded, click on the three dots (...) and click on 'Copy URI'. Now you have the internal ID of this file in your clipboard.
- Go to the developer tools and call the new service manually (see screenshot below)
7. Replace the media_content_id value with the URI of the file you downloaded.
8. Click 'Call Service'. The file should now be played via the 3.5mm headphone jack.
You can use this in any automation now.
Play audio files or use text-to-speech (tts) via the 3.5mm jack of the Raspberry Pi.
This forum post(opens new window) worked for me out of the box.
Send Slack notifications
Here is how it works.
1. Create a new bot in Slack and copy the API key to your clipboard
2. Create this in your configuration.yaml file
3. Now send a slack notification to yourself (e.g. to @johndoe) so Slack 'sees' this bot for the first time. You can do it by manually calling this new service:
4. Now create a new channel in slack (e.g. called #ha) and invite this user in your #ha channel.
You can use this service now to send messages to Slack.
Discussion / Comments
Any comments / suggestions? Check also the discussion of this article on the Home Assistant Forum(opens new window) or the Home Assistant Subreddit(opens new window).
* This is an affiliate link. As an Amazon Associate I earn from qualifying purchases.
30 Sep 2019
Replacing the bootloader and the firmware
The installation (described here(opens new window)) happens in 2 steps. First you need to replace the bootloader. For the camera I used you need to use the 'Xiaomi XiaoFang T20' bootloader. It worked as described. I used a 512 MB SD-Card for this and formatted it on my Mac with FAT16 (FAT32 is recommended). Only challenge is you don't really know when the process is finished so I waited as described on this page and then continued.
Next you need to copy the new firmware(opens new window) onto the SD-Card. You can leave the bootloader binary file on the card if you want.
My file config/wpa_supplicant.conf looks like this:
You need to replace ### with your wifi settings. 'ssid' is the name of your wifi-network and 'psk' is the password one need to login.
Insert the card with the new firmware and the modified config file back into the camera and connect it with power. The camera now should show up in your wifi router and you can access it via https://dafang
Add the camera to Home Assistant
Now I added the camera to my configuration.yaml file. After some initial issues I chose this entry:
You need to adjust the IP address accordingly. Now you should be able add this camera to your homescreen. You can add a card of type 'Picture Entity' with the following content:
Now you should be able to see the current image of the camera
Setting up the MQTT Mosquitto broker
The camera communicates its status via the MQTT protocol, e.g. if there is motion detected. To get this information into Home Assistant you need to install a so called 'MQTT broker'. MQTT stands for 'Message Queuing Telemetry Transport'. Think of it like a post office which is able to retrieve and send messages from/to other devices.
To install a MQTT broker you need to install the Mosquitto broker via Hass.io. Just chose this add-on from the list of official add-ons.
Here is my config file:
As shown you should change the username and password.
I did not make any more changes to my configuration.yaml file.
Next you need to update the file /system/sdcard/config/mqtt.conf on the camera. This is also described here(opens new window).
Here is how my file looks like after the update:
Its important that you change all 'changethis' items with the settings you set in the Mosquitto broker config file and uncomment the AUTODISCOVERY_PREFIX line. Under HOST you add the ip address of the raspberry pi (just do a simple ping hassio.local to find out).
Reboot both HA and the camera. Now you should be able to start the 'mqtt-control' and the 'mqtt-status' services on the camera.
Now if you go to 'Configuration / Integrations' you should see the MQTT integration with all the status information from the camera.
You can now add these sensors and switches to your Overview panel, e.g. by adding this card:
I had the issue that the camera did not send any motion detection messages although everything seems to be configured correctly. I stumbled then across this proposal(opens new window) and adding a swapfile on the camera worked for me as well (July 2019).
Send photos to your slack channel
To get this up and running it took me a lot of time. In the mean time I signed up with the Nabu Casa(opens new window) service. This is what you should do anyway to support the development of this software. I did it because I started with iOS notifications and to send an attachment this attachment needs to be publicly accessible. I moved to slack later to get better image quality and I was using Slack anyway.
To get my feet wet I wanted to create an automation which sends me a picture to Slack (see below how to set up Slack notifications) when the vibration sensor on our cat flap triggers. Here is how the automation looks like:
To make this work you need to create a new folder called 'www' in your config folder. You can use the 'Configurator' add-on to do it:
All elements in this folder are now publicly accessible via the /local folder in the URL shown above.
Your first 'Hello world' automation and notification
To get your feet wet with automations and notifications lets add a simple notification which tells you that your smartphone gets charged. Before we start we need to get to know the ID of your smartphone. To find out, we can use the 'Configurator' add-on we installed earlier. Here open the .ios.conf file and look for your deviceId:
Hassio Docker Raspberry Pi 48
In my case its 'trutz1'.
(BTW: I changed my devices' name a couple of times within the app and suddenly got multiple appearances of sensors, devices and much more on the overview page. To get rid of all this I deleted the iOS integration and cleared the file known_devices.yaml. Then I re-installed the integration and everything was ok again. You might want to boot after each change.)
You should also check the name of your phone's sensors. To find those, go to Configuration > Entity registry. There you can find all your sensors incl. their internal id.
In our case its 'sensor.tkf_battery_state'. Having this information we can start our first automation which triggers a notification to our iPhone. Go to Configuration > Automation and create a new entry here using the following settings:
For the Trigger you choose the Type 'State' and then you select the sensor's name we found out earlier. For the values you enter 'Unplugged' for the 'From' property and 'Charging' for the 'To' property (You can find out the sensors' properties by clicking on them in your overview page).
For the Action you choose 'Call service' as the action type and for the service you use 'notify.ios_' + your deviceId. Then you need to pass a JSON object with a 'message' property. Make sure you are using quotes here.
Now save your first automation and lets test it bei either plugging your phone into the wall or trigger this automation manually. To do the latter just go back one page (don't forget to save) and press the info icon. In the modal you can trigger the automation.
A notification should now be displayed on your iPhone! Yay!
Congratulations! Now you have a working setup and you can start creating your own rules with Home Assistant.
Create backups and snapshots
I had to learn this the hard way so you don't have to. The SD card gets corrupted quickly. Nobody knows why but it happens. So please create 'Snapshots' after each major change and save them locally. Once your SD card becomes unreadable your snapshots stored on the card do not help much.
Another good idea is to push the whole /config directory to Github or your git provider of choice. This literally saved me one time. Use the secrets.yaml file to store your secrets and put it in your .gitignore file.
Installing Hass.io on a SSD
Important note: It seems that the developers of HA/hass.io have changed things on May 2020 (after this initial post was created). Please read the following blog posts:
My installation routine below does not work anymore as the script at https://raw.githubusercontent.com/home-assistant/hassio-installer/master/hassio_install.sh is not available anymore. Not sure, what the best way is currently. Will update this post next time I am updating my installation. Please stick with the official guide(opens new window) for the time being.
Before you start: If you have a running HA installation on your SD card and you would like to restore that on your SSD, then you need to create a 'Snapshot' and download it to your local computer. Also make a backup of your Zigbee gateway in the deCONZ web UI. You don't need it but you never know. Also backup other files you might need later.
After crashing my SDCard for the first time I ordered a cheap SSD (128 GB) for 20 EUR and a connector cable (SATA to USB3 for 9 EUR). You cannot use the hass.io images you use for the SD card, hass.io will not boot. You need to install hass.io as you would do on a generic Linux system. We will use Rasbian for that purpose. However the current version of Raspbian ('Buster') does not really work (as of July 2019). You need to use the earlier version called 'Stretch'. You can get it here:
I found this guide very helpful to enable SSH(opens new window) after flashing the SSD. It seems it is also possible to clone the SDCard(opens new window) but I did not test it. This process takes very long so I decided to go down the Raspian route.
After flashing the SSD you need to login to your Raspberry Pi:
or
Make sure you added your SSH key before. No change your settings (sudo raspi-config) and run the following commands:
This takes some time to complete. After this finished reboot the Pi, e.g. via
Now log back in and run the following commands:
Note that the last line is different to compared to the official guide(opens new window). Also 'add-apt-repository universe' does not apply to Debian based images. This is only needed for Ubuntu.
With 'docker ps' you should now be able to see the 'homeassistant/armv7-hassio-supervisor' container running. Now just wait until a second container called 'homeassistant/raspberrypi3-homeassistant' shows up. This can take some minutes. Now you need to wait again until Home Assistant got installed. This can can 20min as with the SD card. You can check the status via this URL: http://192.168.xxx.yyy:8123/ (adjust the IP accordingly) or http://raspberrypi.local:8123(opens new window).
To install your backup, install the 'Samba share' addon and adjust the config file for this addon, e.g. like this:
Change 'eth0' to 'wlan0' if you are connected via Wifi.
You can connect to this Samba share on the Mac via Finder / Connect with Server / 'cifs://raspberrypi.local'. Copy your local snapshot file to the /backup folder and re-install it via the Web UI of hass.io (I used the 'Restore Selected' option). This takes some minutes to complete. Now your old installation should be back up.
Done!
Troubleshooting
I had the issue that the Xiaomi sensors became unavailable after some hours. Here are some tricks you can do to avoid it:
Update the Conbee II firmware to the latest firmware version.
Within the Phoscon app go to 'Gateway' and check if an update is available. Create a backup before you update.
Conbee II connection
Attach the Conbee II stick not directly to the Raspberry Pi but use an extension cable. Some users reported that this helped with stability.
Check the Zigbee mesh
Hassio Docker Raspberry Pi 45
Zigbee is the network your items communicate on. Not all items might talk directly with your Conbee II gateway but with a repeater instead. Some lightbulbs act as a repeater to increase the range of your Zigbee network. Not all bulbs work very well within this network. You can check which item is connected by activating the deCONZ VNC server. Think of it as a remote monitor. To activate it, set a password and a port (5900 is recommended here) in the deCONZ add-on settings:
Don't forget to hit 'SAVE' in both boxes. Reboot the Pi if you cannot access the server. You now need a VNC-Viewer to access it via vnc://hassio.local:5900 If you are on MacOS you are lucky: The VNC viewer is built it. Just open this URL in the browser and off you go.
This is how the mesh view could look like (these are German friendly-names). The blue item is my Conbee II stick. All items talk directly with the stick in this scenario.
Check if there are other than green lines and try to remove unstable repeaters from your network.
Wifi interferences
If the pairing / connection issues come back, check this great article(opens new window) if you have an incompatible device / repeater in your network. More tipps are found in this thread(opens new window). And this post(opens new window) covers some issues coming from interferences with your 2.4 GHz wifi router.
Check the logs
Activate logging by adding this to your configuration.yaml file. You can use the 'Configurator' add-on to easily do it.
You can now check the log file e.g. via the 'Configurator' add-on (simply way) or log into your Pi via SSH (you need to activate the 'SSH server' add-on to do it) and monitor the live logs with 'tail -f home-assistant.log' on the console. More info about the Logger component here(opens new window).
Fun things to try out
Play audio files (MP3 / WAV) via Raspberry Pi
Install Hassio Docker Raspberry Pi 4
- Install and start the mopidy media play via this(opens new window) instruction. Don't forget to replace YOUR.HOST.IP with your internal IP.
- Create the folder /share/mopidy/media via ssh
- Add this folder to the mopidy add-on config settings (go to Hass.io > Dashboard > Mopidy Add-on), e.g. like this:
- Restart the home assistant server
- Download an audio file of your choice into this folder (/share/mopidy/media) via wget, e.g. you can use this one(opens new window).
- Open this URL in your browser: http://hassio.local:6680/iris/library/browse/local%3Adirectory%3Ftype%3Dtrack
- Find the file you just downloaded, click on the three dots (...) and click on 'Copy URI'. Now you have the internal ID of this file in your clipboard.
- Go to the developer tools and call the new service manually (see screenshot below)
7. Replace the media_content_id value with the URI of the file you downloaded.
8. Click 'Call Service'. The file should now be played via the 3.5mm headphone jack.
You can use this in any automation now.
Play audio files or use text-to-speech (tts) via the 3.5mm jack of the Raspberry Pi.
This forum post(opens new window) worked for me out of the box.
Send Slack notifications
Here is how it works.
1. Create a new bot in Slack and copy the API key to your clipboard
2. Create this in your configuration.yaml file
3. Now send a slack notification to yourself (e.g. to @johndoe) so Slack 'sees' this bot for the first time. You can do it by manually calling this new service:
4. Now create a new channel in slack (e.g. called #ha) and invite this user in your #ha channel.
You can use this service now to send messages to Slack.
Discussion / Comments
Any comments / suggestions? Check also the discussion of this article on the Home Assistant Forum(opens new window) or the Home Assistant Subreddit(opens new window).
* This is an affiliate link. As an Amazon Associate I earn from qualifying purchases.
30 Sep 2019Home Assistant on Docker is easier than running it with HASSIO IMO.
Here is a high-altitude overview of how I run Home Assistant -and- then I'll dig into the details of my setup.
- Setup Raspbian with Docker and Docker-Compose
- Plugin my Aeon Z-wave script; make sure it's on /dev/ttyACM0
- Setup scripts for Docker-Compose
- Setup scripts so it runs on startup
- Create a backup process
Okay, details… here is how I run Home Assistant on Docker on a Raspberry Pi 4.
- Install Raspbian on the Raspberry Pi 4.
- Install Docker and Docker-Compose.
- Create
/root/docker-compose.ymlconsisting of the following (NOTE: I use the Aeon z-wave stick at /dev/ttyACM0):
- Create the following file for automating the service on startup
/etc/systemd/system/home-assistant.service
- Run this
systemctl enable home-assistant.service - Run this
systemctl enable docker
dockerhome-automationhome-assistant ]Related Posts
