No longer maintained

Assistant Relay is no longer maintained, due to lack of time for the project of the creator of Assistant Relay. Also he has no personal need for Assistant Relay anymore. Therefore I have decided to stop maintaining the Docker image (and Hassio add-on) as well. The image will no longer be updated. That also means that the OS of the image will not be updated as well, including security updates.

Assistant Relay Docker

Assistant Relay in Docker. See https://github.com/greghesp/assistant-relay to see how it works and for the release notes.

The image with the tag 'latest' is identical to the newest (non beta) version. The newest beta release is tagged as "beta" and it's release number.

Installation

Create a file in the volume called "config.json" before starting the container:

{
    "port":3000
}

Change the number to the port you want to use.

Docker Run

docker run -d --name assistant_relay \
-p 3000:3000 \
-v /path/to/volume/config.json:/assistant_relay/bin/config.json:rw \
-v /path/to/volume/audio-responses:/assistant_relay/bin/audio-responses:rw \
apipa169/assistant-relay:latest

Docker Compose

version: '3.3'
services:
    assistant-relay:
        container_name: assistant_relay
        ports:
            - '3000:3000'
        volumes:
            - '/path/to/volume/config.json:/assistant_relay/bin/config.json:rw'
            - '/path/to/volume/audio-responses:/assistant_relay/bin/audio-responses:rw'
        image: 'apipa169/assistant-relay:latest'

Beta

If you want to test the beta release you need to run the container in network mode "host" to support the Cast functionality.

The port needs to be defined in the config.json.

docker run -d --name assistant_relay \
--network host \
-v /path/to/volume/config.json:/assistant_relay/bin/config.json:rw \
-v /path/to/volume/audio-responses:/assistant_relay/bin/audio-responses:rw \
apipa169/assistant-relay:beta

ARM / RaspberryPi

Currently ARM is not supported, therefore you can not run this on a RaspberryPi. But there is a workaround by using the Hass.io addon image, without running Hass.io (or Home Assistant).

Docker Run AMRv7

docker run -d --name assistant_relay \
-p 3000:3000 \
-v /path/to/volume/config.json:/data/config.json:rw \
-v /path/to/volume/audio-responses:/data/audio-responses:rw \
apipa169/armv7-hassio-assistant_relay:latest

Home Assistant

Assistant Relay is a great addition to Home Assistant. For the Hass.io add-on see: https://github.com/Apipa169/Assistant-Relay-for-Hassio

The commands described on the add-on page will also work if you are not using the add-on.