Home Assistant integration

Last updated About 21 hours ago

The Gecko integration for Home Assistant lets you control your spa directly from your smart home setup. Once installed, you can adjust temperature, control lights and pumps, switch watercare modes, and monitor connection status alongside all your other devices.

⚠️ This is a community-supported integration available through HACS.
It requires an active in.touch 3 or in.touch 3+ system and a Gecko account.

Before you begin

  • A working Home Assistant installation (version 2023.1 or later recommended)

  • HACS (Home Assistant Community Store) installed on your Home Assistant instance

  • An in.touch 3 or in.touch 3+ module installed, paired, and your spa visible and online in the Gecko app

  • A Gecko account with your spa already set up

⚠️ Compatibility note: This integration only works with in.touch 3 systems. It is not compatible with in.touch 2. If you are unsure which version you have, see How to tell the difference between an in.touch 2 EN and an in.touch 3 EN.

Step 1: Add the integration to HACS

  1. Open HACS from your Home Assistant sidebar.

  2. Go to Integrations.

  3. Click the ⋮ menu in the top-right corner, then select Custom repositories.

  4. In the Repository field, paste:
    https://github.com/geckoal/ha-gecko-integration

  5. Set the Category to Integration, then click Add.

  6. Search for Gecko in the HACS Integrations list and click Download.

  7. Restart Home Assistant to complete the installation.

Step 2: Add the integration in Home Assistant

  1. Go to Settings → Devices & Services.

  2. Click + Add Integration and search for Gecko.

  3. Click on the Gecko integration to open the setup flow.

Step 3: Sign in to your Gecko account

  1. Click Continue to start the sign-in process.

  2. You will be redirected to the Gecko login page. Enter your Gecko account email and password.

  3. Grant Home Assistant permission to access your account.

  4. You will be redirected back to Home Assistant automatically once sign-in is complete.

💡 Tip: Once signed in, your spa is discovered automatically. All controls and sensors appear under Settings → Devices & Services → Gecko.

🎉 You're all set!

What you can control

The integration creates entities in Home Assistant for every controllable feature of your spa:

  • Temperature — Set your target temperature, monitor current water temperature, and track heating status

  • Lighting — Control multi-zone LED lighting independently for each available zone

  • Pumps & blower — Adjust pump speeds across multiple zones and control the air blower

  • Watercare modes — Switch between Away, Standard, Energy Savings, and Weekender modes

  • Connection status — Monitor your gateway connection and RF signal strength

  • Cloud status — See whether your spa is connected to the Gecko cloud and receiving updates

Troubleshooting

If you run into issues after installation, the steps below resolve the most common problems:

  • Integration not appearing after installation — Restart Home Assistant. Also verify that the custom_components/gecko folder exists in your config directory.

  • Sign-in fails — Verify your credentials in the Gecko app first. If that works, check that your Home Assistant instance has internet access.

  • No spa discovered after sign-in — Make sure your spa is online in the Gecko app before starting. Discovery can take 1–2 minutes.

  • Entities not updating or showing stale values — Check the RF signal strength sensor. You can also reload the integration without a full restart: Settings → Devices & Services → Gecko → ⋮ → Reload.

💡 Tip: Most issues are caused by a weak RF signal between the CO (Spa) and EN (Home) modules, or a temporary cloud connection drop. Check both in the Gecko app first.

For issues specific to the integration itself, you can open a report on the GitHub Issues page. For help with your in.touch 3 setup or the Gecko app, contact Gecko Support.