A FHEM complementary Docker image for Amazon alexa voice assistant, based on

• Node 20 - Debian bullseye-slim
• alexa_fhem

Pre-build images are available on Docker Hub and on Github Container Registry.

Updated version, only with Version tags

• NodeJS 20

• Alexa-Fhem 0.5.64

    docker pull ghcr.io/fhem/fhem/alexa-fhem:v5.0.2
  

docker run -d --name alexa-fhem -p 3000:3000 ghcr.io/fhem/fhem/alexa-fhem:v5.0.2

Usually you want to keep your FHEM setup after a container was destroyed (or re-build) so it is a good idea to provide an external directory on your Docker host to keep that data:

docker run -d --name alexa-fhem -p 3000:3000 -v /some/host/directory:/alexa-fhem ghcr.io/fhem/fhem/alexa-fhem:2 

After starting your container, you may check the web server availability:

https://xxx.xxx.xxx.xxx:3000/

You may want to have a look to the alexa-fhem documentation or FHEM Connector documentation for further information.

This image provides different variants:

• latest (default, can introduce breaking changes)
• 2.0.7 ( latest released Version. Can be a prerelease version)
• 2 ( latest stable release in Major v2)
• dev (development tag, not updated anymore)

You can use one of those variants by adding them to the docker image name like this:

docker pull ghcr.io/fhem/fhem/alexa-fhem:latest

docker pull ghcr.io/fhem/fhem/alexa-fhem:2 docker pull ghcr.io/fhem/fhem/alexa-fhem:v5.0.2

If you do not specify any variant, latest will always be the default.

This is a multi-platform image, providing support for the following platforms:

Linux:

• x86-64/AMD64
• ARM32v7, armhf
• ARM64v8, arm64

Windows:

• currently not supported

The main repository will allow you to install on any of these platforms. In case you would like to specifically choose your platform, go to the platform-related section in the container repository.

The platform repositories will also allow you to choose more specific build tags beside the rolling tags latest or dev.

• Change alexa-fhem system user ID: To set a different UID for the user 'fhem' (default is 6062):

    -e ALEXAFHEM_UID=6062
  

• Change FHEM group ID: To set a different GID for the group 'fhem' (default is 6062):

    -e ALEXAFHEM_GID=6062
  

• Set timezone: Set a specific timezone in POSIX format:

    -e TZ=Europe/Berlin
  

No problem at all. To connect alexa-fhem to your alexa container, you need a common network. Named it fhem_net. You should connect your fhem container to the same network to support communication via alexa-fhem and fhem itself.

version: '2.3'

networks:
  fhem_net:
    driver: bridge
    ipam:
      driver: default
      config:
        - subnet: 172.27.0.0/28
          gateway: 172.27.0.1
        - subnet: fd00:0:0:0:27::/80
          gateway: fd00:0:0:0:27::1


services:
  # Minimum example w/o any custom environment variables of fhem container
  fhem:
    image: ghcr.io/fhem/fhem/fhem-docker:bullseye
    restart: always
    networks:
      - fhem_net
    ports:
      - "8083:8083"
    volumes:
      - "./fhem/:/opt/fhem/"

 # Minimum example w/o any custom environment variables of alexa-fhem container
 alexa-fhem:
    image: ghcr.io/fhem/fhem/alexa-fhem:v5.0.2
    restart: always
    networks:
     - fhem_net
    ports:
      - "3000:3000"
    volumes:
      - "./alexa-fhem/:/alexa-fhem/"
    environment:
      ALEXAFHEM_UID: 6062
      ALEXAFHEM_GID: 6062
      TZ: Europe/Berlin

If you use another name for your fhem container fhem, or want to use another tcp port for fhemweb connections, then you have to change the alexa-fhem config file in the volume for your alea-fhem container ./alexa-fhem/alexa-fhem.json.

In the connections part, servername and port must match withhin fhem configuration:

"connections": [
    {
      "name": "FHEM",
      "webname": "fhem",
      "filter": "alexaName=..*",
      "uid": "6062",
      "port": "8083",
      "server": "fhem"
    }
  ]

Within FHEM, you have to specify a alexa device and add attribute to identify the host. In this example, the container name is alexa-fhem, so this is also the hostname.

define alexa alexa
attr alexa alexaFHEM-host alexa-fhem

SSH and other attributes are not needed for running in a docker environment

Production Build and Test

Development Build and Test