How to install Home Assistant on Portainer
Description
In this tutorial, I use a raspberry pi to show you how to install Home Assistant on Portainer. You don’t need a raspberry pi, other hardware also works.
Requirements
This tutorial requires you to have Portainer already installed. For instructions on how to do that look into the official documentation.
Step By Step Guide
1. Find the right docker image
There are several docker images for Home Assistant optimized for a specific system. I am using a raspberry pi 3 so I use this image:
You can find an overview of all the docker images and other installation options here.
2. Add a new container
Go to your Portainer Containers and add a new container.
3. Basic settings
Give your container a name and paste the image name you selected on docker hub.
4. Volumes
Bind these two volumes to link the config files to a host folder and bind the local time for synchronization.
I use ‘/home/pi/homeassistant/config’ as my config directory you can use whatever you like.
5. Network
Change the network mode to ‘host’.
6. Restart policy
Change the restart policy to ‘unless stopped’.
7. Runtime & Resources
Go to ‘Runtime & Resources’ and enable the privileged mode
8. Deploy the container
Click ‘deploy the container’ and wait for the deployment to finish.
This can take a couple of minutes.
9. Open Home Assistant
The default port for Home Assistant is 8123. So you just have to go to the host IP address + port in your browser.
e.g. 192.123.123.123:8123
10. Enjoy
Now you will be asked to create an account and then Home Assistant should automatically detect all the smart home devices in your local network.
On the configurations page you can select ‘Devices & Services’ to set up new automatically detected services and devices and add new integrations.
Also when you want to use Home Assistant on your phone you can install the Companion App for Android or iOS. You can also find the app on F-Droid, Play Store and App Store.
Thanks for reading. Leave a comment when you have some feedback. If you liked it consider buying me coffee.
Sources
- Portainer installation instructions: https://www.portainer.io/install
- Install Home Assistant on docker: https://www.home-assistant.io/installation/raspberrypi#raspberry-pi-3
- Home Assistant installation package info: https://www.home-assistant.io/installation/
- Companion App Android: https://github.com/home-assistant/android
- Companion App iOS: https://github.com/home-assistant/iOS
