Nefariously Programmed Mecha
Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »


0.2.35 • Public • Published

MyDomoAtHome nodeJS

REST Gateway between Domoticz and Imperihome ISS

NPM Version NPM REST DOCKER DOCKER PayPal donate button

LICENSE MP REST REST REST REST Documentation en Français: MyDomoAtHome

Important update

Our repository has moved to https, so if you have an update message, please do the following:

sudo nano /etc/apt/sources.list

Add modify to https the line to have this :

deb /

Features and goals

The goal of this project is to provide a REST API to ImperiHome ISS that would allow to see the current state of sensors and interact with them in case of an actuator.

Reached M1 Goal reached - first version in Perl Dancer after ISS has been announced

Reached M2 Goal reached - full rewrite to node js with debian packaging, simpler install and upgrade, better performance, less dependencies

  • Free but you can show you like it ! PayPal donate button

  • Multi-platform (Linux, Mac OS X, Windows)

    • Dependency-less
    • Node.js rewrite
    • Installation / usage logs
  • Debian package - noarch

    • Auto updatable through apt-get
    • Third-party hosting
  • Micro-services (Docker)

    • Image available on Docker Hub
  • Synology

    • Synology compatible docker image
  • Support major type of sensors/feature of Domoticz

    • Weather and Environmental sensors
    • Energy sensors (Electricity, Gas, Water)
    • Switches
    • Thermostat
    • Dynamic room creation
    • RGB lamps (Limitless/Applamp/Hue) (depending on Domoticz)
    • Push On buttons (depending on Imperihome)

Reached M3 Goal reached - full graphs, flexible room usage and UI improvements

  • Support major type of sensors/feature of Domoticz
    • Devices following planID
    • Graphs
    • Groupe switches with instant energy
    • Security code managed

M4 milestone will provide extended support to other platforms with Docker and Synology

  • End to end authentificaton
  • HTTPS support
  • Support domoticz Farenheit
  • Synology
    • Synology hosted package
  • Debian package - noarch
    • debian hosted package - need a peer
    • raspbian hosted package
  • TODO
    • Evohome (depending on Imperihome)
    • Alarm pannel (partial with ImperiHome)
    • Auto updatable through button

PayPal donate button

Standalone installation (PI, cubie, odroid, intel...)


Install procedure

Check the nodeJS version installed - mandatory for PI !

sudo dpkg --list |grep nodejs // should return version 4.x or above

If not please do:

On RASPBIAN (Raspberry PI/PI2/PI3), please install first to have a stable nodeJS :

sudo apt-get remove node
wget -q
sudo dpkg -i nodejs_4.4.2_armhf.deb
wget -q
sudo dpkg -i npm_2.14.7_armhf.deb
sudo npm install -g npm@2.x

On all other (debian, ubuntu...), version 4 is required (testing/unstable are fine):

sudo apt-get remove node
sudo dpkg -r nodejs npm
curl -sL | sudo -E bash -
sudo apt-get install -y nodejs

The following commands install npm and then upgrade it to the latest 2.x version.

sudo npm install -g npm@2.x

Note: npm version 3 is the latest version, but is currently not recommended for use.

And check again

node —version // should print version 4.4.x or similar
npm —version // should print version 2.2.x or similar

Installing the software Debian package .deb

wget -qO - | sudo apt-key add -
sudo nano /etc/apt/sources.list

Add the line:

deb /


sudo apt-get update
sudo apt-get install MyDomoAtHome 

Important remark: do not install as root, but sudo as an unprivilegied user.

Edit the configuration file with your values:

 sudo nano /etc/mydomoathome/config.json

 sudo service mydomoathome restart

Installing the software on Synology

Add to your Synology NAS Package Center sources !

The package is node-mydomoathome

Domoticz will run on port 8084 and MDAH on 3002.

Remember to set in Domoticz Settings/Local Networks

Installing the software on Windows

download and install nodejs here:

download zip here: (green clone or download button right)

unzip locally

click window touch+R, type in 'cmd' and enter

go in the unzipped repository

npm install
node mdah.js

to launch do from a cmd window:

node mdah.js 

configuration "config.json" must be in the same directory as the file mdah.js


It works in a "key":"value" mode. Basic values are:

  "app_name": "MyDomoAtHome",
  "auth": null,
  "tempmode": "C",
   "domoticz": {
    "ssl": false,
    "host": "",
    "port": "8080",
    "path": "/",
    "auth": null
  "port": "3002",
  "passcode": ""
  • multi-instances: just change the app_name tag between instances

  • change the MDAH port: change the basic (top level) port (here 3002)

  • protected device code: change the passcode above

  • access domoticz in ssl mode: change domoticz:port and ssl to true

  • change domoticz host or port: do it on domoticz:host and domoticz.port

  • add a login/pass to access MDAH:change top-level "auth": null to

    "auth": { "username": "admin", "password": "admin" },

  • manage login/pass on domoticz, do the same in domoticz:path

  • start in https mode:

      openssl genrsa 1024 > key.pem
      openssl req -x509 -new -key key.pem > key-cert.pem
    "app_name": "MyDomoAtHome",
    "auth": null,
    "tempmode": "C",
    "https" : true,
    "key" : "test/fixtures/keys/key.pem",
    "cert": "test/fixtures/keys/key-cert.pem",
    "domoticz": {
      "ssl": false,
      "host": "",
      "port": 8080,
      "path": "/"
   "port": 3002,
   "passcode": ""

Stuck on a pre 0.1.x version

apt-get remove mydomoathome
apt-get update
apt-get install MyDomoAtHome

Migrating from old/Legacy MyDomoAtHome

Shut down the old service

sudo service stop
rm /etc/init.d/

N.B. you can have the both at the same time, just chane the App name in the config.json file and the port.

Migrating from ISS-DOMO

edit /etc/mydomoathome/config.json with your previous port (was 8000 default), change app_name value to ISS-Domo and then restart the service

Running the service

The default port is now 3002.

Start the service:

sudo service mydomoathome start

Stop the service :

sudo service mydomoathome stop

Restart the service :

sudo service mydomoathome reload

Docker installation (only for those using this form: big Synologies, Xpenologies...)

Docker image is automatically build based on latest verion. Configuration can be passed through command line (see below) /etc/mydomoathome is also mounted

Duplicate the image

docker pull epierre/iss-mdah

Launch the process

Remember to change the IP below and authorize in Domoticz the docker IP range

docker run --name=mdah --env DOMO="http://your_ip:8080" --env TZ=Europe/Paris -p 3002:3002 epierre/mdah

Check running docker processes

docker ps

Stoping a docker process

docker stop mdah 

Testing the installation

  • Check in a browser it is running


  • From there you'll get the following links in the browser.

  • Check the domoticz is accessible from the hosting machine

    curl http://domoticz_ip:domoticz_port/json.htm?type=devices&filter=all&used=true&order=Name
  • Check the MDAH returns the result from the hosting machine

    curl http://gateway_ip:gateway_port/devices

Accessing the Gateway from the outide of your network

The best way is to setup the nginx for both domoticz and the gateway:

sudo apt-get install nginx-full sudo apt-get install openssl sudo apt-get install haveged

In the domoticz configuration add a section to redirect to the gateway such as this (change your ip below)

location /iss/ {
  proxy_set_header X-Real-IP  $remote_addr;
  proxy_set_header X-Forwarded-For $remote_addr;
  proxy_set_header Host $host;
  access_log /var/log/nginx/mdah.access.log;
  error_log /var/log/nginx/mdah.error.log;

Advanced support

For an unsupported device or any issue with a particular device, please report with it the JSON from Domoticz with this URL:




  • Remember to add the gateway in the local networks under setup in domoticz !


npm i node-mydomoathome

Downloadsweekly downloads









last publish


  • avatar