/alexa-fhem-docker

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

Primary LanguageShellMIT LicenseMIT

Docker image for alexa-fhem

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

Installation

Pre-build images are available on Docker Hub. We recommend pulling from the main repository to allow automatic download of the correct image for your system platform:

docker pull fhem/alexa-fhem

To start your container right away:

docker run -d --name alexa-fhem -p 3000:3000 fhem/alexa-fhem

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 fhem/alexa-fhem 

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

http://xxx.xxx.xxx.xxx:3000/

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

Image flavors

This image provides 2 different variants:

  • latest (default)
  • dev

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

docker pull fhem/alexa-fhem:latest

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

latest will give you the current stable Docker image, including up-to-date alexa-fhem. dev will give you the latest development Docker image, including up-to-date alexa-fhem.

Supported platforms

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

Linux:

  • x86-64/AMD64 Link
  • i386 Link
  • ARM32v5, armel not available
  • ARM32v7, armhf Link
  • ARM64v8, arm64 Link

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 repository by clicking on the respective link above.

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

Customize your container configuration

Tweak container settings using environment variables

  • 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
    

Production Build Status

Development Build Status