2025-07-29 14:34:10 +02:00

2.2 KiB
Raw Blame History

Installation Guide

Step 1: Configure the Futurehome App

  1. Enable Local API

    Open the Futurehome app and navigate to: Settings > My household > Smarthub, then set up Local API.

    Local API screen
  2. (Optional) Install Thingsplex Integration

    Thingsplex is an integration for debugging hub adapters. It's also used by this add-on to support pairing and unpairing devices.

    • Go to Settings > Integrations, install and start "Thingsplex Advanced UI".
    • Open the integrations "..." menu, set a username and password, then save.
    Thingsplex screen
  3. (Optional but recommended) Block WAN Access To prevent future firmware updates that might break local functionality, block the hubs internet access via your router settings.


Step 2: Set Up in Home Assistant

  1. Enable MQTT Integration

    In Home Assistant, go to Settings > Devices & Services > Integrations and enable MQTT.

  2. Install the Futurehome Add-on

    Click the button below to install the Futurehome add-on in your Home Assistant:

    Open your Home Assistant instance and show the dashboard of an add-on.

    Finally, configure and start the add-on.

Add-on config screen

Troubleshooting

Q: My Futurehome trial expired and I cant modify hub settings to enable Local API. What can I do?

  1. Perform a factory reset on the hub.
  2. Open the Futurehome app, create a new household, and re-add the hub.