Set up Home Assistant on a QNAP NAS

Home Assistant is a free and open-source software for home automation that is designed to be the central control system for smart home devices with focus on local control and privacy. It supports a wide range of devices and can be installed onto most major platforms, such as Windows, Linux, macOS, Raspberry Pi, ODroid, etc.

The best way to run Home Assistant is on a dedicated device, which could be any PC, whether it’s a Raspberry Pi or a full-fledged PC. If you have a NAS already connected to your network and runs 24/7, having Home Assistant installed on top of it would be the perfect choice.

In this article, we will show you how to set up Home Assistant on a QNAP NAS running QTS with Docker. The guide was tested against my QNAP TS-853 Pro running QTS 4.3.3 and up-to-date Container Station.

QNAP Container Station

QNAP Container Station is a feature that allows you to run LXC/LXD and Docker based container on your QNAP NAS running QTS operating system.

Container Station also provides popular and fully-configured applications with just one click to deploy them. You can choose LibreOffice, MongoDB, Nginx, Node.js, Redis, MySQL, WordPress, Deluge, Minecraft, Wine, Jenkins, GitLab, Redmine, Joomla!, and much more.

Container Station allows you to import containers and images from a local computer or from other NAS, as well as pulling directly from Docker Hub. The supported formats are *.tar, .tar.gz, and *.tgz.

Home Assistant Docker Image

Home Assistant officially released a Docker container in Docker Hub. It’s a standalone container-based installation of Home Assistant Core that works perfectly on a Raspberry Pi or a local server.

In order to use the container, you have to provide two variable:

  • /PATH_TO_YOUR_CONFIG points at the folder where you want to store your configuration and run it. In this example, we are going to use a share on the QNAP NAS at /Container/homeassistant_config.
  • MY_TIME_ZONE is a string TZ name, for example: TZ=America/Los_Angeles. The list of all TZ database name can be found at

Install Home Assistant on QNAP NAS using commands

This is by far the simplest method to install Home Assistant on a QNAP NAS. Suppose you’ve got the latest firmware installed as well as Container Station enabled, simply run the command below to have Home Assistant installed using Docker :

docker run -d \ --name="home-assistant" \ --privileged \ --restart=unless-stopped \ -e TZ=America/Los_Angeles \ -v /Container/hass_config:/config \ --network=host \ docker run --init -d --name="home-assistant" -v /Container/hass_config:/config -v /etc/localtime:/etc/localtime:ro --net=host homeassistant/home-assistant:latest
Code language: JavaScript (javascript)

Once the installation completes without any errors, Home Assistant should be accessible using http://hostname:8123 (with hostname being the actual the hostname or IP of the NAS).

Install Home Assistant on QNAP using GUI

Alternatively, you can install Home Assistant on QNAP using its graphical interface. Home Assistant is still going to run through Docker and uses /Container/homeassistant_config as its configuration file.

Follow the steps below to have the Home Assistant Docker container installed:

  • Launch Container Station and select Create section.
  • Search for the Docker image named “homeassistant/home-assistant” in Docker Hub, then select Install
  • Choose the stable channel, then select Next
  • Type in the container name (“home-assistant” for example). You can also set system resources for the container as per your use case.
  • After that, switch to Advanced Settings, click Volume from host > Add in Shared Folders, then select a folder to store your configuration. You can choose /config to be the mount point.
  • Within Network section, set Network Mode to Host.
  • In Environment section, create a variable named tz by clicking the plus bitton, then enter the TZ value of your location, for example: TZ=America/Los_Angeles. The list of all TZ database name can be found at Specifying the right TZ value ensure that the time stay synchronized between the Docker container and the NAS operating system.
  • Finally click Create to fetch the container from Docker Hub and create it.

Once completed, your Home Assistant should be available on port 8123 and accessible via http://hostname:8123 (with hostname being the actual the hostname or IP of the NAS).

Notice: In order to reinstall your Home Assistant on your Docker within QNAP NAS, you can simply remove container and image either by using its graphical interface or run docker rm, then repeat the steps above. Don’t delete the config folder unless there’s a misconfiguration that affects the container.

We hope that the post helped you successfully installed Home Assistant in your QNAP NAS. While quite easy to set up, remember that the hardware of the NAS may not be powerful enough to run multiple Docker containers at the same time.

If you need more horsepower to feed into Docker and have an old computer lying around, you may try to set up an Ubutu-based NAS, which will certainly be more capable without breaking the bank. The old NAS can be converted into a media server easily by installing one of the best open-source DLNA servers. If you have any suggestion, please feel free to leave a comment below.

Leave a Comment