Complete integration of the Poolex Aqualyser pool in Home Assistant

With the warm season back, the pool is up and running again — and with it, the daily job of keeping the water balanced. If you own a Poolex Aqualyser Multi salt chlorinator, you have a capable device in your hands… but it becomes far more powerful once it is driven from Home Assistant.

In this article, I walk you step by step through integrating the Poolex Aqualyser Multi into Home Assistant with the community Tuya Local (HACS) integration, and then through fully automating your pool management with a dedicated Blueprint I developed and released for free.

What’s on the menu: recognising the Tuya device, installing the integration, creating the required helpers, importing the blueprint — all of it following the manufacturer’s recommendations to the letter.

Introducing the Poolex Aqualyser Multi

The Poolex Aqualyser Multi is a new generation salt water chlorinator designed to make pool maintenance effortless and to keep your water clean and balanced at all times. Compatible with pools up to 90 m³, this smart system automatically adjusts chlorine production and regulates the pH thanks to its built-in Redox, pH, temperature and flow sensors.

It is more than just an electrolyser: the Aqualyser also works as a pH pump and an ORP controller, for complete and fully automated water management. Confident in its quality, Poolex offers a 5-year warranty on the housing and 10,000 hours on the titanium cell.

When it comes to connectivity, it embeds a Tuya chip running firmware 3.5 and is natively controlled through the Poolex app. That very chip is what lets us bring it into Home Assistant over a direct local connection — without going through the Tuya cloud.

Two versions available

The Aqualyser comes in two versions to fit every type of installation:

• Total version: compact, designed for an easy installation, ideal for above-ground pools and tight spaces
• Flex version: modular, for traditional technical rooms that need a custom installation

Technical specifications

How much salt do you need?

Recommended salinity is 2.7 to 5 g/L (that is 2.7 to 5 kg/m³). Here are indicative quantities depending on the volume:

Check the salt concentration regularly, especially after heavy rain or partial water renewals.

What the Aqualyser Multi exposes in Home Assistant

What the Poolex Aqualyser Multi exposes as data and commands:

Prerequisites

Before you start, make sure you have:

• A Poolex Aqualyser Multi connected and working through the Poolex/Smart Life app
• An up-to-date Home Assistant instance (2024.x minimum recommended)
• HACS 2.0 installed on your Home Assistant
• a Smart Life account with the Poolex Aqualyser added
• A file editor to add the poolex_aqualyser.yaml file

Step 1 — Install Tuya Local through HACS

Tuya Local is a community integration that lets you control Tuya devices locally, without relying on the cloud. It supports hundreds of devices thanks to a library of YAML description files maintained by the community.

1.1 Add the repository in HACS

In Home Assistant, open HACS and click the ⋮ menu → Custom repositories. Add the following URL with the Integration category:

https://github.com/make-all/tuya-local

Or click the button above to add the repository and install Tuya Local from HACS.

1.2 Install the integration

Once the repository is added, search for Tuya Local in HACS → Integrations, install it and then restart Home Assistant.

1.3 Add the integration in Home Assistant

After the restart, go to Settings → Devices & services → + Add integration, search for Tuya Local and follow the steps:

3. Find your user code

Open the Smart Life app on your smartphone — there is no need to install the official Poolex app: the Poolex Aqualyser must be added to the Smart Life app.

1. Go to the Profile tab (bottom right)
2. Tap Settings (gear icon, top right)
3. Tap Account and security
4. The user code is displayed on this page — copy it

4. Enter the user code in Tuya Local

When configuring the Tuya Local integration in Home Assistant, enter this user code in the dedicated field. The integration then automatically retrieves the device_id and the local_key for every device detected on your local network.

Step 2 — Add the Poolex Aqualyser device file to Tuya Local

Tuya Local recognises devices through YAML configuration files describing their data points (DPs). I created and maintain the description file for the Poolex Aqualyser Multi, covering all the data and commands of the device.

The poolex_aqualyser.yaml device file

Here is the device description file I wrote, which covers every data point of the device:

name: Salt chlorinator
products:
  - id: uabbsm8ioqunhgos
    manufacturer: Poolex
    model: Aqualyser Multi
    model_id: B3CR

entities:
  # Main switch (dp 101)
  - entity: switch
    dps:
      - id: 101
        name: switch
        type: boolean

  # Reported output level (dp 102, read-only)
  - entity: sensor
    name: Output
    dps:
      - id: 102
        type: integer
        name: sensor
        unit: "%"
        class: measurement

  # Pool volume (dp 103)
  - entity: number
    name: Pool volume
    category: config
    icon: "mdi:pool"
    dps:
      - id: 103
        type: integer
        name: value
        unit: m³
        range:
          min: 5
          max: 200
        mapping:
          - step: 5

  # Chlorination time (dp 104)
  - entity: number
    name: Chlorination time
    category: config
    icon: "mdi:timer-outline"
    dps:
      - id: 104
        type: integer
        name: value
        unit: h
        range:
          min: 1
          max: 24

  # Polarity reversal interval (dp 105)
  - entity: number
    name: Reverse interval
    category: config
    icon: "mdi:swap-vertical"
    dps:
      - id: 105
        type: integer
        name: value
        unit: h
        range:
          min: 2
          max: 8
        mapping:
          - step: 2

  # BOOST mode (dp 106)
  - entity: switch
    name: Boost
    icon: "mdi:car-turbocharger"
    category: config
    dps:
      - id: 106
        name: switch
        type: boolean

  # Output level - setting (dp 107)
  - entity: number
    name: Output level
    category: config
    icon: "mdi:signal"
    dps:
      - id: 107
        type: integer
        name: value
        unit: "%"
        range:
          min: 20
          max: 100
        mapping:
          - step: 20

Checking recognition

Once the integration is configured with the right IP and local_key, Tuya Local tries to recognise the device automatically through its product_id. If the Poolex Aqualyser Multi is detected correctly, all the entities listed in the Devices & services section of Home Assistant will show up.

Step 3 — Create the required Helpers

The automation blueprint needs two helpers in Home Assistant. Create them before importing the blueprint.

Helper 1 — Filtration Timer (Mandatory)

This timer is used by the blueprint to handle the automatic stop of the filtration pump. Its duration is computed and injected dynamically by the blueprint — there is no need to set a default duration.

1. Go to Settings → Devices & services → Helpers
2. Click + Create helper → Timer
3. Fill in:
   • Name: Timer Filtration
   • Duration: leave empty or 0
   • Restore state on restart: ✅ enabled
4. Click Create

Helper 2 — High bather load (Optional)

This toggle helper lets you switch between normal and high bather load. It affects the chlorination and filtration durations in the 28–30°C range.

1. Go to Settings → Devices & services → Helpers
2. Click + Create helper → Toggle
3. Fill in:
   • Name: Pool High Bather Load
4. Click Create

Step 4 — Import the automation Blueprint

This is where the whole power of this integration comes in: the complete automation blueprint developed specifically for the Poolex Aqualyser Multi.

What the blueprint does

This blueprint fully automates the chlorinator management while following the official Poolex manufacturer recommendations:

Built-in safety:

• ❄️ Winter safety: the Aqualyser and the pump switch off automatically when the water temperature drops below 10°C
• 🔄 Automatic restart: if the Aqualyser is turned off manually (from the app or physically), it starts again automatically as soon as the temperature is back above 10°C

Adaptive chlorination based on temperature:

Adaptive filtration based on temperature (granular):

Production rate based on pool volume:

Polarity reversal based on water hardness (TH):

Supported triggers:

• ⏰ Daily start at a configurable time
• 🌡️ Crossing of each temperature threshold (15 thresholds from 10°C to 30°C)
• 🏠 Home Assistant start
• 👥 Change of the high bather load switch
• 🔌 Detection of the Aqualyser being switched off → auto restart if T° ≥ 10°C (with a 5s debounce)
• ⏱️ End of the filtration timer → pump stop

Importing the blueprint

Click the button below to import the blueprint straight into your Home Assistant:

Or from the Home Assistant UI: Settings → Automations & scenes → Blueprints → Import blueprint and paste the URL:

https://github.com/haade-administrator/blueprint_poolex_aqualyser/blob/main/poolex_aqualyser_blueprint.yaml

Step 5 — Create the automation from the Blueprint

Once the blueprint is imported, all that is left to do is create the automation and configure it with your entities.

Go to Settings → Automations & scenes → + Create automation → From a blueprint and select “Poolex Aqualyser - Filtration & Chlorination Management”.

Parameters to fill in:

1. Aqualyser switch → the Poolex switch entity (main switch)
2. Boost switch → the Poolex switch.boost entity
3. Chlorination time number → the number.chlorination_time entity
4. Output level number → the number.output_level entity
5. Reverse interval number → the number.reverse_interval entity
6. Filtration pump → the switch entity of your pump
7. Temperature sensor → your pool water temperature sensor
8. Timer Filtration → the timer helper created in step 3
9. Start time → the time at which the cycle should start every day
10. Pool volume → the volume of your pool in m³
11. Water hardness (TH) → the hardness of your water in French degrees
12. High bather load (optional) → the toggle helper created in step 3

Enable the automation and Home Assistant now runs your pool fully autonomously, adapting the treatment and filtration durations in real time according to the water temperature.

How it works in practice

Here is an example of what the blueprint triggers on a hot summer day with a 30 m³ pool, water at 27°C and a hardness of 25°f:

1. At the scheduled time, the cycle starts
2. The blueprint reads the temperature (27°C) and computes:
   • Chlorination duration: 6h
   • Filtration duration: 15h
   • Production rate: 40% (30 m³ pool)
   • Polarity reversal interval: 8h (TH < 30°f)
3. The Aqualyser is switched on with the right settings injected through Tuya Local
4. The filtration pump starts and the 15h timer is launched
5. After 6 hours of chlorination, the Aqualyser switches off automatically
6. After 15 hours, the timer expires and the pump stops

If in the meantime the temperature crosses a threshold (going from 27°C to 28°C for example), the blueprint recalculates immediately and updates the treatment durations accordingly — without any action from you.

Official Poolex video tutorials

Poolex publishes complete installation and configuration tutorials for the Aqualyser on its YouTube channel. I recommend watching them before starting the physical installation.

Installing and connecting the Aqualyser Total — Full tutorial

This first official Poolex tutorial covers the entire 8-step installation: unboxing, hydraulic and electrical installation, initial setup, probe calibration, pH pump test and Wi-Fi connection to the app.

Complete Aqualyser Flex installation guide

For owners of the Flex version, intended for traditional technical rooms, Poolex offers a dedicated video guide covering the specifics of its modular installation.

Fixing a falling pH - Aqualyser Total

In this tutorial, we show you how to fix a pH problem that drops instantly on the Aqualyser Total.

Customer reviews and feedback

Before integrating the Aqualyser Multi into Home Assistant, I naturally looked into user feedback. Here is an honest dashboard of what stands out from forums and verified reviews.

What users like

Positive feedback keeps coming back to a few strong points:

The all-in-one versatility is unanimously praised. The Aqualyser is an electrolyser, an ORP controller and a pH pump at the same time — a combination that dramatically simplifies the technical installation and reduces the number of devices in the technical room.

Automation is the second strength. Automatic chlorine and pH regulation based on real-time measurements is perceived as real freedom. Several users report not touching their water treatment manually for the whole season.

The Poolex app gets good feedback for its readability and its alerts when something goes wrong. Checking pH, ORP and temperature graphs remotely reassures owners who go on holiday.

The titanium cell rated for 10,000 hours is also an argument for trust, especially compared with other brands whose cells wear out faster in hard water.

Things to know before buying

Probe quality: some users report pH or REDOX probes that need more frequent recalibration in very hard water (TH > 40°f). The blueprint’s polarity reversal protocol is precisely designed to counter this phenomenon.

Network compatibility: the Aqualyser only supports 2.4 GHz Wi-Fi. If your technical room is far from your internet box, a Wi-Fi repeater or a separate access point connection will be needed.

The Home Assistant integration solves several limitations of the official app: no long-term history in Poolex, no automatic adaptation to the water temperature, no high bather load mode. With the blueprint, these gaps disappear completely.

Personal experience

For my part, the integration through Tuya Local is remarkably stable. The direct local communication removes any dependency on the Tuya cloud — which means that even if the Poolex servers are unavailable, your automation keeps running perfectly. That is a considerable advantage compared with controlling everything through the app alone.

The reported data points (output rate, temperature, boost mode) also let you build complete tracking dashboards in Home Assistant, or even cross automations (stop the Aqualyser if you detect a pump failure, send a notification if the temperature goes above a threshold, and so on).

Frequently asked questions

Can I use this blueprint with the Aqualyser Total version (not Multi)? The blueprint was designed for the Multi model, which exposes the output, boost and chlorination data points through Tuya. The Total version may have different DPs — check the GitHub repository for any updates.

My Aqualyser is already paired with the Poolex app. Is that a problem? No, you can keep the Poolex app installed. Tuya Local and the official app coexist without conflict. However, commands sent from the app can sometimes be overridden by the blueprint a few seconds later — that is normal.

Does the blueprint work if Home Assistant restarts in the middle of a filtration cycle? Yes. The filtration timer helper is configured to restore its state on restart. On the next HA start, the timer resumes where it left off.

Can I change the filtration or chlorination durations computed by the blueprint? The blueprint strictly follows Poolex recommendations. If you want to customise the values, you will need to edit the blueprint YAML directly — which is entirely possible for advanced users.

Conclusion

Integrating the Poolex Aqualyser Multi into Home Assistant through Tuya Local is a real success. Where the official app is limited to manual control, Home Assistant turns this chlorinator into a fully autonomous, smart and adaptive water treatment system.

What I particularly like about this solution:

• ✅ 100% local communication — no cloud, no latency, no risk of outage
• ✅ Manufacturer recommendations respected — durations and rates are computed from the official Poolex guide
• ✅ Restart-proof — the timer survives Home Assistant restarts
• ✅ No code to write — everything is configured through the blueprint UI
• ✅ Modularity — high bather load mode is enabled with a switch for busy swimming days
• ✅ Advanced tracking — Tuya data lets you build complete dashboards in HA

The tuya-local device file and the blueprint are freely available on GitHub, maintained and open to contributions. If you own a Poolex Aqualyser Multi and Home Assistant, you no longer have any excuse to manage your pool by hand.

Enjoy your swim! 🏊‍♂️