Ambientika local cloud

This software is meant for personal use only and the repository will not be actively maintained.

❗ There is an actively maintained fork as Home Assistant Addon by Alex Lenk

The NodeJS application provides an api compatible interface to the ambientika cloud. The devices can be controlled and monitored locally and optionally connected to native ambientika cloud.

The integration into Home Assistant is done via MQTT. Home Assistant MQTT and auto discovery.

Information about the protocol, provisioning and communication can be found here.

To use this software the traffic from the devices need to connect directly via port 11000/TCP to this application. This can be achieved via DNAT, static routes or changing the cloud endpoint on the devices in the provisioning process. Or may there are further possibilities to achieve this.

Protocol

To build this application the ambientika protocol was analyzed, for further details visit: Protocol documentation

NodeJS build

npm install
npm start

OR

npm build

Docker build

docker build -t $imagename .

Start Docker

To use all features of this application the application or docker container must be run in the same subnet of the devices. This is needed due the nature of UDP broadcasts.

Minimal docker compose example

services:
  ambientika:
    image: ghcr.io/sragas/ambientika-local-control:release
    restart: unless-stopped
    container_name: ambientika-local
    env_file: /docker/ambientika/env
    network_mode: host
    cap_add:
      - NET_ADMIN

Configuration

Default configuration is found in .env Provide following configuration via env_file:

MQTT_CONNECTION_STRING

And change other values matching your setup. i.e

ZONE_COUNT

Connection to ambientika cloud can be disabled with:

CLOUD_SYNC_ENABLED=false