Skip to content

Install

Unofficial integration

Not affiliated with or supported by Dimplex. It works by talking to the same private cloud API the official app uses, discovered by reverse-engineering that app. Dimplex can change that API without notice.

Before you start

  • Home Assistant 2026.9 or later — the floor this integration declares in hacs.json. Earlier releases are not merely untested: the integration links each appliance to its hub with the device-registry APIs introduced in 2026.8 (via_device_id and async_get_device_by_identifier), so on an older version no entities are created at all.
  • A Dimplex cloud account with at least one registered appliance, working in the official Dimplex Control app.
  • Internet access from your Home Assistant instance. This is a cloud-polling integration; there is no local API.

Check the official app first

If your heater does not appear, or shows no temperature, in the Dimplex Control app, it will not appear here either. The integration reads the same cloud.

Install

  1. Open HACS in Home Assistant.
  2. Search for Dimplex Hub.
  3. Click Download.
  4. Restart Home Assistant.

Or use the one-click link: Add to HACS

Stay on the stable channel for everyday use. Pre-releases (vX.Y.Z-rc.N and vX.Y.Z-pr.*) exist for testers — only enable them in HACS if you intend to run unreleased code. See pre-release builds.

  1. Open your Home Assistant configuration directory — the folder containing configuration.yaml.
  2. Create custom_components/ if it does not already exist.
  3. Copy custom_components/dimplex from the repository into it.
  4. Restart Home Assistant.

The Python client dimplex-controller is declared in manifest.json and installed automatically on first load.

Add the integration

  1. Go to Settings → Devices & services.
  2. Click + Add integration.
  3. Search for Dimplex Hub and select it.
  4. Follow the prompts — see connect your account for the two login methods.

Check it worked

After setup finishes:

  • Settings → Devices & services shows a Dimplex Hub entry, loaded without an error banner.
  • Clicking it lists one device per appliance, plus a hub device and a device per zone.
  • Each appliance device has a climate entity reporting a room temperature.
  • Settings → Devices & services → Entities, filtered on dimplex, lists around 20 entities per appliance — many are diagnostic and disabled by default.

If entities appear but read unavailable, that is usually the cloud returning an empty overview because the heaters have not telemetered recently rather than a setup problem — see entities are unavailable.

Next