• You can support more guides like this Click to Donate
  • Version
  • Create Date January 30, 2024
  • Last Updated February 2, 2024
  • Installation Support Ask Support

Open source home automation

In this tutorial i will show you how to install HomeAsistant using Portainer

If you don't have the Docker Engine and Portainer apps installed on your NAS, install them using this guide Docker Engine and Portainer. If you have them already installed, proceed further.

If you already have them from a previous container installation, proceed to Step 3. If not, follow this guide to launch a web terminal and run the command :


You can also use putty or any other SSH client. In this case, ssh service must run on your NAS

Find your current time zone on this website, as example for Brussels is:


Open Portainer using the icon from TOS desktop ( if Portainer is already installed and enabled), or enable Portainer from App Center and open it from there by typing in your web browser http://yournasip:19000.

Note. If you open the Portainer via the TOS desktop icon, you can face an error message during deployments of big images. If you want to access portainer only for Stack update (without repulling the image) then you can do it via the TOS desktop icon.

After you login on Portainer, go to Home, then click on your Local Environment

Go to Stacks and click on Add stack

On the name type homeassistant, select Web editor and paste the code below.

Make sure you replace the PUID and PGID with the values for your user found on Step 2
Make sure you replace the TZ value with the value for your specific zone found on Step 3

Config files will be stored at /Volume1/DockerAppsData/HomeAssistant

device: section is optional, only if you want to make a device connected to your NAS visible by homeassistant.
In the example below i choosed my USB to serial adapter /dev/ttyUSB0

restart: you can choose from always, unless-stopped, or on-failure[:number of retries]

version: "3.9"
    image: lscr.io/linuxserver/homeassistant:latest
    container_name: homeassistant
    network_mode: host
      - PUID=0
      - PGID=0
      - TZ=Europe/Brussels
      - /Volume1/DockerAppsData/HomeAssistant:/config
      - 8123:8123
      - /dev/ttyUSB0:/dev/ttyUSB0
    restart: on-failure:5

After you adapt the needed values, scroll down and click on Deploy the stack. The button will change to Deployment in progress.

If no errors occur, you will get a message that deployment was successful and the homeassistant stack will appear on the list. Click on it.

If everything was OK, the container will show as running.

Navigate to http://yournasip:8123 to open the homeassistant interface

Go through the setup steps, some devices will be detected and installation is completed.

User Reviews
You are not allowed to post review.