evan/home-assistant-futurehome
1
0
Fork 0
mirror of https://github.com/adrianjagielak/home-assistant-futurehome.git synced 2025-10-04 10:47:10 +00:00
Code Issues Packages Projects Releases Wiki Activity
home-assistant-futurehome/docs/installation.md
Andreas 060947e06b
Update installation.md (#7) 
Clarify that users must select the MQTT Integration instead of the hub’s MQTT server, with step-by-step guidance provided.
2025-09-25 00:41:47 +02:00

2.3 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 integration’s "..." 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 hub’s internet access via your router settings.

Step 2: Set Up in Home Assistant

  1. Enable MQTT Integration

    Add the MQTT integration by going to Settings → Devices & Services → Integrations → Add integration, search for and select MQTT → MQTT, then choose "Use the official Mosquitto MQTT Broker add-on".

  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 can’t 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.