Also checkout the quickstart guides in the menu on the left! If you are planning on installing room-assistant on multiple hosts Ansible will automate the process for you.

Running with NodeJS

Dedicated or resource-limited computers, like Raspberry Pis. Has least overhead but may conflict with other services, particularly those based on different versions of Node.js.


Please make sure you have either NodeJS 16.x, 14.x or 12.x installed. The version provided by Raspbian by default is outdated. Installation guides for NodeJS can be found hereopen in new window. For Pi Zero devices you will need to use a different installation process.

room-assistant instances use some native dependencies for discovering each other in the local network using mDNS and providing health checks for systemd. You will require two additional system packages to get this working:

sudo apt-get install libavahi-compat-libdnssd-dev libsystemd-dev

Note that some of the integrations may also require system packages to be installed, please look at the documentation of the integrations you want to use for this information.


You can install room-assistant using npm with the following command:

sudo npm i --global --unsafe-perm room-assistant

npm will link the binary for running the software, usually into /usr/bin/room-assistant. If the directory is already in your PATH you can start it directly by typing room-assistant. Otherwise you can start it by typing the full path name of where it was installed.


During installation you may see a lot of messages like the one in the image below scroll by. Don't worry - these are not errors! This is just the output of dependencies being compiled. As long as npm does not say that the installation ran into an error at the end you are good.

compilation messages

Making it a service

To make sure room-assistant always runs on your machine you can create a system service for it. Create the file /etc/systemd/system/room-assistant.service similar to the following example:

Description=room-assistant service



After you have your config ready - in the above example it should be located in /home/pi/room-assistant/config/ - you can start and enable the service with:

sudo systemctl enable room-assistant.service
sudo systemctl start room-assistant.service

Running with Docker

Computers being used as general servers. Slightly more overhead but avoids possible conflicts with other services.


This project provides official Docker images on Docker Hubopen in new window. You can either use the latest or a specific version by using the correct tag. It is strongly recommended to run this image with the host network, otherwise you may run into problems with many parts of the software. For auto-discovery functionality on Linux you will need to map the /var/run/dbus volume.

Example docker-compose.yml
version: '3'
    image: mkerix/room-assistant
    network_mode: host
      - /var/run/dbus:/var/run/dbus

Running with Home Assistant OS

You can install room-assistant as Home Assistant OS add-on by adding the following URL as repositoryopen in new window: