How to Install Home Assistant on Portainer

  • Post author:WunderTech
  • Post published:November 18, 2023
  • Post last modified:November 26, 2023
  • Post category:Docker
  • Reading time:7 mins read

In this tutorial, we’re going to look at how to install Home Assistant on Portainer (using Docker). I really like using Docker for Home Assistant when possible as it’ll allow you to migrate the configuration at a later date.

The natural progression is to either move Home Assistant from a powerful device like a hypervisor to a lower-powered device like a Raspberry Pi, or the opposite. Portainer and Docker make this process incredibly easy, as you can simply move the configuration to a separate device whenever you’d like.

How to Install Home Assistant on Portainer

1. If you don’t have Docker and Portainer set up, do it before proceeding as we’ll be utilizing Portainer for the installation.

While you can also use a simple Docker run command for Home Assistant, I find it easier to utilize Portainer for the maintenance/upkeep of containers (especially updating Docker containers) which is why I’ll be utilizing this approach in this tutorial.

2. Launch and log in to Portainer. Select Volumes then Add Volume.

3. Give the volume the name Home-Assistant, then select Create the volume.

4. Select Containers, then Add Container.

creating the container for home assistant

5. Give the container a Name, then enter the image below. Make sure you select the correct image. For most, the option below will be the default, but you might need to use a different version based on the CPU architecture (ARM, x86, etc) you’re currently using.


6. Select publish a new network port and map the host port 8123 to the container port 8123. If you’re using this port for something else (unlikely), please select a different host port number. 

modifying the ports in portainer

7. Select Volumes, then map additional volume. Select the volume we created earlier and map it to the /config location.

mounting the volumes in portainer

8. Change the restart policy to Always.

setting the container to restart automatically

9. In the Runtime & Resources section, enable Privileged Mode.

adding privileged mode

10. In the Environment Variables section, create an environment variable named TZ for your time zone.

adding timezone environment variable

11. You can now Deploy the container.

Configuring Home Assistant

1. Give the container a few minutes to create, then navigate to the IP address of Portainer and port 8123.


2 Create an account for Home Assistant.

setting a name and password for home assistant

3. Select your location and the unit type you’d like to use, then select Next. If you’d like to share anonymous information, you can at the next step.

selecting the location of home assistant

4. Home Assistant will automatically find devices on your local network. You can now set up any other integrations that you’d like! Home Assistant will now be set up and configured, so you can modify it however you’d like!

Conclusion & Final Thoughts

This tutorial showed how to install Home Assistant on Portainer using Docker. Home Assistant can be set up in various ways, but I find that installing it on Portainer is a great option if you already have Docker and Poratiner set up. It’s just so easy to manage your containers using Portainer, that it makes sense to utilize it.

Thanks for checking out the tutorial on how to install Home Assistant on Portainer. If you have any questions, please leave them in the comments!


Frank is an IT professional with 13+ years experience and the creator of WunderTech. He focuses on sharing his experience with others on computer hardware, servers, software, networking, and self-hosted apps. He has a BS in Computer Information Systems and an MBA. Learn more about Frank in his bio.