Version: Next

Whilst there isn't an official Docker image for, there are a number of 3rd Party Implementations.

The most active seems to be Assistant-Relay-for-Hassio from Apipa169

Getting started#

To use this add-on you need to have running. If you are not using you should use the docker image or install Assistant Rely directly on your system.


  1. Go to Supervisor in the sidebar and click on Add-on Store
  2. Add under "repositories"
  3. The add-on Assistant Relay should now show up below. Clcik on it and click on "Install". This may take a while, depending on your internet and system speed.


  1. You do not need to configure anything at the add-on page. Click "Start" to run the add-on
  2. Check the log below to see if it's running.
  3. Click on "Open web UI" or go to http://[IP]:[PORT] in your browser.
  4. Follow the instructions in the browser.
  5. You can now use Assistant Relay.

The IP must be the IP address of your system, not the one mentioned in the log as this is the address of the container. The port is 3000 by default

Changing the port number#

If you want to change the port of Assistant Relay, please do this in the add-on settings and leave the Assistant Relay setting on port 3000.


User needs always to be the user you used in the setup of AR. Multiple users is suported by AR.

Home Assistant REST#

Example command to broadcast via a rest command.

# Example configuration.yaml
method: POST
content_type: 'application/json'
payload: '{"command":"{{ command }}", "user":"username", "broadcast":true}'
method: POST
content_type: 'application/json'
payload: '{"command":"{{ command }}", "user":"username", "converse":true}'
method: POST
content_type: 'application/json'
payload: '{"command":"{{ command }}", "user":"username"}'
# Example test lovelace card
type: entities
- action_name: Broadcast
name: test broadcast
service: rest_command.assistant_broadcast
type: call-service
command: hello, this is a test broadcast
# Automation action example (just fill in "command: hello" if you are using the editor)
- data:
command: hello
service: rest_command.assistant_broadcast

Node Red Example#

Simple flow for Node Red which can be imported. Copy all the code and go to the hamburger menu > import in NodeRed.

Don't forget to change the IP address, port and user after you have imported this sequence.

[{"id":"cb8e2985.0fd68","type":"comment","z":"e0fa9d52.876058","name":"Broadcast via Google Home","info":"","x":180,"y":180,"wires":[]},{"id":"37f701c2.826d96","type":"delay","z":"e0fa9d52.876058","name":"","pauseType":"rate","timeout":"5","timeoutUnits":"seconds","rate":"1","nbRateUnits":"10","rateUnits":"second","randomFirst":"1","randomLast":"5","randomUnits":"seconds","drop":true,"x":320,"y":220,"wires":[["d087aae2.ab98e"]]},{"id":"eba065b9.0d066","type":"http request","z":"e0fa9d52.876058","name":"post","method":"POST","ret":"obj","paytoqs":false,"url":"","tls":"","persist":false,"proxy":"","authType":"","x":730,"y":220,"wires":[[]]},{"id":"d087aae2.ab98e","type":"function","z":"e0fa9d52.876058","name":"set payload and headers","func":"msg.message = msg.payload;\nmsg.payload = {\n \"name\": \"username\",\n \"command\": msg.message,\n \"broadcast\": true\n};\nmsg.headers = {};\nmsg.headers['Content-Type'] = 'application/json';\nreturn msg;","outputs":1,"noerr":0,"x":530,"y":220,"wires":[["eba065b9.0d066"]]},{"id":"e63ec3ee.7abb68","type":"inject","z":"e0fa9d52.876058","name":"","topic":"","payload":"Hello everyone!","payloadType":"str","repeat":"","crontab":"","once":false,"onceDelay":0.1,"x":140,"y":220,"wires":[["37f701c2.826d96"]]}]