Awesome Open Source
Awesome Open Source

Simple SONOFF Server

DISCONTINUED due to certification problems on newer firmwares. See this issue for details.

Current State => Not finished yet, but works most of the time.

A lot of this code is based on the findings in this blog and

The idea was to have an Openhab Binding. And this is the concept implementation, that works good enough for me to start with. It can be used in combination with the HTTP Binding.


I suggest to use => It solves a lot of problems like taking care of starting/stoping the server or keeping it running.

If you still want to use this directly:

Change the sonoff.config.json to fit your environment.

The "server" is the device, which should stay in contact with the SONOFF devices. In my case it was the Raspverry Pi, which also runs Openhab.

  • "httpsPort" can be any port.
  • "websocketPort" can be any port.

But make sure, that your router is allowing communication between devices.

    "router": {
        "SSID": "##########",
        "password": "###########"
    "server": {
        "IP": "",
        "httpPort": 1080,
        "httpsPort": 1081,
        "websocketPort": 443

Setup a new device

There are two ways of setting up the devices. Either with the sonoff.setupdevice.js script, or with wget (or anything else that can post an http request to a specific server).


Start sonoff.setupdevice.js on a computer you like. It will connect to the SONOFF device, so you will lose internet connection. When the scripts runs, you must long-click the black button on the device, and it will be configured to use the "server" as its cloud. Which now runs in your own network.

To run this on a linux device, the network manager must be installed. On an raspberry pi I would suggest to do the setup process manually with wget.


(thanks @andrewerrington)

  1. Put the SonOff/Wemos device in AP mode (press and hold button for 5s)
  2. Find the device and connect to it (SSID: ITEAD-10000xxxxx Password: 12345678)
  3. Add route if necessary sudo route change mask
  4. (optional) use wget to read device info wget -O-
  5. use wget to send local WiFi settings to device wget -O- --post-data='{"version":4,"ssid":"yourSSID","password":"yourSSID_PASSWORD","serverName":"n.n.n.n","port":1081}' --header=Content-Type:application/json ""

The device will automatically drop out of AP mode and tries to connect to WiFi and server.

running the server

Start sonoff.server.js This Server keeps the connection to the sonoff devices, and must run permanently.

  • /devices => list off all devices that are currently known to the server.
  • /devices/:deviceId/status => shows the status of the device
  • /devices/:deviceId/on => turns the device "on"
  • /devices/:deviceId/off => turns the device "off"

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
javascript (68,676
sonoff (24

Find Open Source By Browsing 7,000 Topics Across 59 Categories