sudo raspi-config<\/code><\/p>\n\n\n\nDon’t forget to start ssh, if you need remote ssh access.<\/p>\n\n\n\n
Install Docker<\/h4>\n\n\n\n
We’ll assume you execute everything with a pi user or another who has sudo privileges<\/p>\n\n\n\n
Execute<\/p>\n\n\n\n
sudo apt install docker.io<\/code><\/p>\n\n\n\nDon’t forget to add yourself to docker group, so you can execute docker commands without sudo:<\/p>\n\n\n\n
sudo usermod pi -a -G docker<\/code><\/p>\n\n\n\n(replace pi with the user you’re using, if needed). You need to logout and login for the changes to take effect.<\/p>\n\n\n\n
After that, what I do is install a few scripts that will help me manage everything<\/p>\n\n\n\n
cd<\/code>
mkdir docker<\/code>
mkdir scripts<\/code>
cd scripts<\/code>
<\/p>\n\n\n\nUse your favorite editor, mine is mcedit.<\/p>\n\n\n\n
Portainer ( $HOME\/scripts\/run_portainer<\/code> )<\/h5>\n\n\n\n#!\/bin\/bash\n\ndocker pull portainer\/portainer-ce\n\ndocker stop portainer\ndocker rm portainer\n\ndocker run --name=portainer \\\n --restart=unless-stopped -d \\\n -l \"diun.enable=true\" \\\n -v \/var\/run\/docker.sock:\/var\/run\/docker.sock \\\n -v $HOME\/docker\/portainer:\/data \\\n -p 9000:9000 \\\n -p 8000:8000 \\\n portainer\/portainer-ce<\/code><\/pre>\n\n\n\nReplace $HOME\/docker <\/code>with the actual location where you want to store your docker files locally ( if you don’t it will create in your home folder ). This helps next time when you’re rebuilding docker instances so you don’t lose anything.<\/p>\n\n\n\nMake it executable and run it:<\/p>\n\n\n\n
chmod +x run_portainer
.\/run_portainer<\/code><\/p>\n\n\n\nThis will start portainer on port 9000. You can open it via web browser on http:\/\/IP<\/strong>:9000<\/code> and set it up. It’s a great software to monitor at and manage your docker environment.<\/p>\n\n\n\nMQTT ( $HOME\/scripts\/run_mqtt<\/code> )<\/h5>\n\n\n\nMQTT is really important piece of software, that will allow all our gateways and sensors to actually send data to Home Assistant. Edit $HOME\/scripts\/run_mqtt<\/code>:<\/p>\n\n\n\n#!\/bin\/bash\n\ndocker stop mqtt ; docker rm mqtt\n\ndocker pull eclipse-mosquitto\n\ndocker run --name mqtt -d --restart=unless-stopped \\\n -p 1883:1883 \\\n --net mqtt \\\n --ip 192.168.20.10 \\\n -l \"diun.enable=true\" \\\n -v $HOME\/docker\/mqtt\/config:\/mqtt\/config \\\n -v $HOME\/docker\/mqtt\/log:\/mqtt\/log \\\n -v $HOME\/docker\/mqtt\/data\/:\/mqtt\/data\/ \\\n eclipse-mosquitto<\/code><\/pre>\n\n\n\nOf course, replace $HOME\/docker<\/code> (if you need to).<\/p>\n\n\n\nchmod +x $HOME\/scripts\/run_mqtt<\/code><\/p>\n\n\n\nDo not run it yet. We need to configure user and password first.<\/p>\n\n\n\n
cd $HOME\/docker
mkdir -p mqtt\/config mqtt\/log mqtt\/data
cd mqtt\/config<\/code><\/p>\n\n\n\nThen create a file, called mosquitto.conf<\/code> with the following content<\/p>\n\n\n\nport 1883\npassword_file \/mqtt\/config\/passwd\nallow_anonymous false<\/code><\/pre>\n\n\n\nCreate the mqtt network. Here we use static IP address for the MQTT server, so that the other container we can configure to use that IP address. If you want, you can omit that, but it’s better to just leave it.<\/p>\n\n\n\n
docker network create -d bridge --subnet=192.168.20.0\/24 mqtt<\/code><\/p>\n\n\n\nNow you can start it for the first time:<\/p>\n\n\n\n
cd $HOME\/scripts
.\/run_mqtt<\/code><\/p>\n\n\n\nNow it’s time to generate password. Enter into the container with:<\/p>\n\n\n\n
docker exec -it mqtt \/bin\/sh<\/code><\/p>\n\n\n\nThen execute<\/p>\n\n\n\n
mosquitto_passwd -c \/mqtt\/config\/passwd hass<\/code><\/p>\n\n\n\nEnter the password when prompted twice. Try to use generated or hard to guess password. You can add as many users you want, just omit the -c<\/code> flag next time. <\/p>\n\n\n\nYou can now exit the container with ctrl + d<\/code>. Your MQTT server is configured. We’ll use that for Home assistant configuration.<\/p>\n\n\n\nHome assistant itself ( $HOME\/scripts\/run_hass<\/code> )<\/h5>\n\n\n\nYou can configure several things in this shell script, but we’ll get to that. For now, use the basics<\/p>\n\n\n\n
#!\/bin\/sh\n\ndocker pull homeassistant\/home-assistant\n\ndocker stop hass; docker rm hass\n\ndocker run -d --name=hass \\\n --net=host \\\n --restart=unless-stopped \\\n -v $HOME\/docker\/hass:\/config \\\n homeassistant\/home-assistant\n<\/code><\/pre>\n\n\n\nHere we tell it to use host network, so we don’t need to explicitly map ports. This will have some other advantages later. Save it, chmod +x $HOME\/scripts\/run_hass<\/code> and run it.<\/p>\n\n\n\ncd $HOME\/scripts && .\/run_hass<\/code><\/p>\n\n\n\nYou can now configure Home Assistant initially from http:\/\/IP<\/strong>:8123\/<\/code> , replace IP with rpi’s IP address.<\/p>\n\n\n\nAfter doing this, open $HOME\/docker\/hass\/configuration.yaml<\/code> and add the following section<\/p>\n\n\n\nmqtt:\n broker: localhost\n client_id: hass\n username: hass\n password: PASSWORD_HERE\n discovery: true\n discovery_prefix: homeassistant\n birth_message:\n topic: 'hass\/status'\n payload: 'online'\n will_message:\n topic: 'hass\/status'\n payload: 'offline'<\/code><\/pre>\n\n\n\nOf course, replace PASSWORD_HERE<\/code> with your MQTT password.<\/p>\n\n\n\nYou can now restart home assistant from within the web interface or via run_hass<\/code> command.<\/p>\n\n\n\nWhen you’re finished, you will have your first Home Assistant setup. While pretty basic, it’s already ready to be customized.<\/p>\n\n\n\n
We will look into this very soon \ud83d\ude42<\/p>\n","protected":false},"excerpt":{"rendered":"
I will describe quickly how to set-up and prepare RPI4 for Home Assistant. We will use this as a base to install docker and configure everything. You can use the imager from here , but use the lite image. You don’t need the desktop version. Install Raspberry OS Don’t forget to update and upgrade all packages: apt update && sudo apt upgrade , then reboot. When you first boot, you can configure the system with sudo raspi-config Don’t forget to start ssh, if you need remote ssh access. Install Docker We’ll assume you execute everything with a pi user or another who has sudo privileges Execute sudo apt install docker.io Don’t forget to add yourself to docker group, so you can execute docker commands without sudo: sudo usermod pi -a -G docker (replace pi with the user you’re using, if needed). You need to logout and login for the changes to take effect. After that, what I do is install a few scripts that will help me manage everything cdmkdir dockermkdir scriptscd scripts Use your favorite editor, mine is mcedit. Portainer ( $HOME\/scripts\/run_portainer ) Replace $HOME\/docker with the actual location where you want to store your docker files locally ( […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[4,5],"tags":[10,18,20,22],"class_list":["post-284","post","type-post","status-publish","format-standard","hentry","category-home-assistant","category-software","tag-docker","tag-mqtt","tag-portainer","tag-raspberry"],"_links":{"self":[{"href":"https:\/\/dev.krasi.net\/index.php?rest_route=\/wp\/v2\/posts\/284","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/dev.krasi.net\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/dev.krasi.net\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/dev.krasi.net\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/dev.krasi.net\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=284"}],"version-history":[{"count":0,"href":"https:\/\/dev.krasi.net\/index.php?rest_route=\/wp\/v2\/posts\/284\/revisions"}],"wp:attachment":[{"href":"https:\/\/dev.krasi.net\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=284"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/dev.krasi.net\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=284"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/dev.krasi.net\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=284"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}