{"id":42980934,"url":"https://github.com/fhem/alexa-fhem-docker","last_synced_at":"2026-03-08T23:04:30.317Z","repository":{"id":34198086,"uuid":"164209813","full_name":"fhem/alexa-fhem-docker","owner":"fhem","description":"A FHEM complementary Docker image for Amazon alexa voice assistant, based on Debian.","archived":false,"fork":false,"pushed_at":"2026-01-14T06:32:50.000Z","size":461,"stargazers_count":5,"open_issues_count":4,"forks_count":2,"subscribers_count":1,"default_branch":"dev","last_synced_at":"2026-01-14T10:20:02.413Z","etag":null,"topics":["alexa","alexa-fhem","docker-fhem","fhem","fhem-alexa","fhem-docker","home-automation","home-automation-system"],"latest_commit_sha":null,"homepage":"https://fhem.de/","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fhem.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2019-01-05T11:43:53.000Z","updated_at":"2026-01-01T09:41:56.000Z","dependencies_parsed_at":"2023-11-30T20:25:52.791Z","dependency_job_id":"94c211ee-b2e9-47ac-b01a-4bfe97a5e0f2","html_url":"https://github.com/fhem/alexa-fhem-docker","commit_stats":null,"previous_names":[],"tags_count":65,"template":false,"template_full_name":null,"purl":"pkg:github/fhem/alexa-fhem-docker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fhem%2Falexa-fhem-docker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fhem%2Falexa-fhem-docker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fhem%2Falexa-fhem-docker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fhem%2Falexa-fhem-docker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fhem","download_url":"https://codeload.github.com/fhem/alexa-fhem-docker/tar.gz/refs/heads/dev","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fhem%2Falexa-fhem-docker/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28926504,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-30T22:32:35.345Z","status":"ssl_error","status_checked_at":"2026-01-30T22:32:31.927Z","response_time":66,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["alexa","alexa-fhem","docker-fhem","fhem","fhem-alexa","fhem-docker","home-automation","home-automation-system"],"created_at":"2026-01-31T01:44:41.568Z","updated_at":"2026-01-31T01:44:42.092Z","avatar_url":"https://github.com/fhem.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Docker image for alexa-fhem\nA [FHEM](https://fhem.de/) complementary Docker image for Amazon alexa voice assistant, based on \n- [Node 22 - Debian bookworm-slim@sha256](https://hub.docker.com/_/node/tags?page=1\u0026name=22-bookworm-slim@sha256)\n- [alexa_fhem](https://www.npmjs.com/package/alexa-fhem?activeTab=versions)\n\n\n\n## Installation\nPre-build images are available on [Docker Hub](https://hub.docker.com/r/fhem/alexa-fhem) and on [Github Container Registry](https://github.com/orgs/fhem/packages/container/package/fhem/alexa-fhem).\n\n\n### From Github container registry\nUpdated version, only with Version tags\n- NodeJS 22\n- Alexa-Fhem 0.5.65\n\n        docker pull ghcr.io/fhem/alexa-fhem:5.1.6\n\n#### To start your container right away:\n\ndocker run -d --name alexa-fhem ghcr.io/fhem/alexa-fhem:5.1.6\n\n\n### Permanent storage\nUsually 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:\n\n    docker run -d --name alexa-fhem -v /some/host/directory:/alexa-fhem ghcr.io/fhem/alexa-fhem:5.1.6\n\n#### Verify if container is runnung\nAfter starting your container, you may check the web server availability:\n\n\thttp://xxx.xxx.xxx.xxx:3000/\n\nYou may want to have a look to the [alexa-fhem documentation](https://wiki.fhem.de/wiki/Alexa-Fhem) or [FHEM Connector documentation](https://wiki.fhem.de/wiki/FHEM_Connector) for further information.\n\n\n### Image flavors\nThis image provides different variants:\n\n- `latest` (default, can introduce breaking changes)\n- `2.0.7` ( latest released Version. Can be a prerelease version)\n- `5` ( latest stable release in Major v5)\n- `dev` (development tag, not updated anymore)\n\nYou can use one of those variants by adding them to the docker image name like this:\n\n\tdocker pull ghcr.io/fhem/alexa-fhem:latest\n  docker pull ghcr.io/fhem/alexa-fhem:5\t\n\tdocker pull ghcr.io/fhem/alexa-fhem:5.1.6\n\nIf you do not specify any variant, `latest` will always be the default.\n\n### Supported platforms\nThis is a multi-platform image, providing support for the following platforms:\n\n\nLinux:\n\n- `x86-64/AMD64` \n- `ARM32v7, armhf` \n- `ARM64v8, arm64` \n\n\nWindows:\n\n- currently not supported\n\n\nThe main repository will allow you to install on any of these platforms.\nIn case you would like to specifically choose your platform, go to the platform-related section in the container repository.\n\nThe platform repositories will also allow you to choose more specific build tags beside the rolling tags latest or dev.\n\n\n## Customize your container configuration\n\n\n#### Tweak container settings using environment variables\n\n* Change alexa-fhem system user ID:\n\tTo set a different UID for the user 'fhem' (default is 6062):\n\n\t\t-e ALEXAFHEM_UID=6062\n\n* Change FHEM group ID:\n\tTo set a different GID for the group 'fhem' (default is 6062):\n\n    \t-e ALEXAFHEM_GID=6062\n\n* Set timezone:\n\tSet a specific timezone in [POSIX format](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones):\n\n    \t-e TZ=Europe/Berlin\n\n## Use docker-compose.yaml\nNo problem at all. To connect alexa-fhem to your alexa container, you need a common network.\nNamed it fhem_net. You should connect your fhem container to the same network to support communication via alexa-fhem and fhem itself.\n\n```\nversion: '2.3'\n\nnetworks:\n  fhem_net:\n    driver: bridge\n    ipam:\n      driver: default\n      config:\n        - subnet: 172.27.0.0/28\n          gateway: 172.27.0.1\n        - subnet: fd00:0:0:0:27::/80\n          gateway: fd00:0:0:0:27::1\n\n\nservices:\n  # Minimum example w/o any custom environment variables of fhem container\n  fhem:\n    image: ghcr.io/fhem/fhem-docker:4-bullseye\n    restart: always\n    networks:\n      - fhem_net\n    ports:\n      - \"8083:8083\"\n    volumes:\n      - \"./fhem/:/opt/fhem/\"\n\n # Minimum example with some custom environment variables of alexa-fhem container\n alexa-fhem:\n    image: ghcr.io/fhem/alexa-fhem:5.1.6\n    restart: always\n    networks:\n     - fhem_net\n    volumes:\n      - \"./alexa-fhem/:/alexa-fhem/\"\n    environment:\n      ALEXAFHEM_UID: 6062\n      ALEXAFHEM_GID: 6062\n      TZ: Europe/Berlin\n```\n\nIf 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`.\n\n## Configuration of alexa-fhem container\n\nThe config file is placed in the volume /alexa-fhem.\nIf not already present, it will be created here.\n\nIn the connections part, servername and port must match withhin fhem configuration:\n```\n\"connections\": [\n    {\n      \"name\": \"FHEM\",\n      \"webname\": \"fhem\",\n      \"filter\": \"alexaName=..*\",\n      \"uid\": \"6062\",\n      \"port\": \"8083\",\n      \"server\": \"fhem\"\n    }\n  ]\n```\n\nStarting with Docker image version 5.1.x, you can control every setting via an environment variable provided by the Docker host. This means there is no need to edit any configuration files manually. All environment variables starting with the common prefix \"CONFIG_\" are evaluated and added to the configuration file.\n\nTo enable SSL for communication with FHEMweb, add an environment variable CONFIG_connections_0_ssl=true. If your container running FHEM is named differently, use the environment variable CONFIG_connections_0_server='fhem.docker.local'. To use another TCP port for communication with FHEM, set the environment variable CONFIG_connections_0_port='8088'.\n\nThe settings for Alexa can also be changed. Here are some examples:\n\n`CONFIG_alexa_port=4000`\n`CONFIG_alexa_name=myAlexaSkill`\n`CONFIG_alexa_ssl=true`\nAdditionally, the SSH proxy settings can be changed if needed:\n\n`CONFIG_sshproxy_ssh='/usr/bin/ssh'`\n## Configuration of FHEM configuration\n\nWithin FHEM, you have to specify a alexa device and add attribute to identify the host. \nIn this example, the container name is `alexa-fhem`, so this is also the hostname.\n\n```\ndefine alexa alexa\nattr alexa alexaFHEM-host alexa-fhem\n```\n\nSSH and other attributes are not needed for running in a docker environment.\nalexa-fhem is running correctly if you have reading like this:\n\n`alexaFHEM.ProxyConnection = running; SSH connected`\n`alexaFHEM.bearerToken = \u003csome secret value\u003e`\n`alexaFHEM.skillRegKey = crypt:\u003csome long value\u003e`\n\nYou will also see a internal `alexa-fhem version` \n\n\n\n\n\n___\n[Production Build and Test](https://github.com/fhem/fhem/alexa-fhem-docker/workflows/Build%20and%20Test/badge.svg?branch=master)\n\n[Development Build and Test](https://github.com/fhem/fhem/alexa-fhem-docker/workflows/Build%20and%20Test/badge.svg?branch=dev)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffhem%2Falexa-fhem-docker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffhem%2Falexa-fhem-docker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffhem%2Falexa-fhem-docker/lists"}