Skip to content
HomeHome.App

Install guide

Install guide

Install the firmware

From a bare board to Apple Home in 8 steps. Installing HomeHome.App firmware is free: you flash it from your browser in about two minutes, then set it up from your phone.

Free to installChrome or Edge on a computerUSB data cable2.4 GHz Wi-Fi
ESP32BridgeeWeLink / Sonoff devices in Apple Home. ESP32 DOIT DevKit, Wemos D1 R32 or Wemos D1 Mini ESP32.Open the ESP32 Global flasher
ESP32Water Level ControlESP32 DOIT DevKit – the only supported board.Open the ESP32 flasher
ESP8266Castle Black · Relay & ShutterNodeMCU LoLin V3 (ESP8266, CH340G).Open the ESP8266 flasher

8 steps

  1. Plug in the board

    Connect the board to your computer with a USB data cable.

    Some cables only charge. If your computer does not see the board, try another cable first.

  2. Open the flasher for your board

    Use the buttons above, in Chrome or Edge on a Windows, macOS or Linux computer.

    Flashing uses Web Serial – phones, tablets, Safari and Firefox cannot flash a board.

  3. Click Connect and pick the port

    Choose your board's port in the list that pops up.

    Not in the list? Try another USB cable or port. Still nothing? Install the USB driver for the chip printed next to the USB socket: CP210x or CH340.

  4. Click Install

    Wait until it says it is done – 1 to 2 minutes.

    Stuck on "Connecting…"? Hold the BOOT button on the board while it connects, then let go. On some boards: hold BOOT, plug in the USB cable, then release it.

  5. Restart it and join its Wi-Fi

    Unplug the board and plug it in again. From your phone, join the setup Wi-Fi HomeHome-XXXXXX (the Bridge shows HomeHome.App). Password: homehome.

    No setup Wi-Fi? Unplug the board, wait 5 seconds and plug it in again.

  6. Fill in the setup page

    It opens by itself – if not, reconnect. Choose your device type, type your Gmail address, then pick your 2.4 GHz Wi-Fi and enter its password.

    Bridge only: sign up at bridge.homehome.app with the same email address and link your eWeLink account. Then restart the Bridge and wait 1–2 minutes.

  7. Add it in the Home app

    Tap +, then enter the code 111-88-111.

    Code refused? Unplug the board, plug it in again and try within 90 seconds.

  8. Try it, then switch it on

    Every device starts in demo mode by itself – the Bridge for 24 hours, other devices usually for 10 to 20 on/off changes. To keep it working, buy Maker Credits and write your Gmail address in the order note. When we have added the credits, restart the device.

    How many credits you need: Maker Credits.

Full guide with troubleshootingFAQ
Still stuck? Tell us your board and the step where it stopped. Chat on WhatsApp or email info@homehome.app.