Skip to content

Connect VoltraX to Home Assistant

Home Assistant talks to your strips directly on your home network, over an encrypted connection with its own key. No internet needed; linking your VoltraX account is an optional ☁ fallback.

Install

Copy the voltrax folder of the VoltraX Home Assistant integration into the folder below and restart Home Assistant (2025.8 or newer).

config/custom_components/voltrax/
  1. 1

    In the VoltraX app, open the strip and choose People → Invite → Home Assistant. You get a code starting with mttl3: (valid 10 minutes, works once).

  2. 2

    In Home Assistant, the strip shows up under Settings → Devices & services → Discovered. Click Configure. Without discovery, add VoltraX and enter the strip’s address (for example mttl-xxxxxxxx.local).

  3. 3

    Paste the invite code. Home Assistant makes its own key; it never leaves Home Assistant.

  4. 4

    Optional ☁: choose Link VoltraX account to keep control while the home network link is down. You sign in on VoltraX and approve which strips Home Assistant may read and control — no password is stored in Home Assistant.

  5. 5

    Done. One device per strip, with the outlet names you set in the app.

What you get, per strip

Names follow the outlet names set in the app and update when you rename.

  • switchOne switch per outlet, plus one for all outlets
  • sensorPower, voltage and current, for the strip and per outlet
  • sensorEnergy, for the strip and per outlet (total increasing)
  • numberAuto-off timer per outlet, in minutes
  • buttonRestart per outlet (off, then on again)
  • binary_sensorWhether the strip reaches VoltraX Cloud

Worth knowing

  • Home Assistant has the Home Assistant role: it can switch, restart and time outlets. Schedules, names, the child lock, protection and power-on are changed in the app.
  • Energy can’t be reset from Home Assistant. Use a utility_meter helper for totals you can reset.
  • The child lock only locks the buttons on the strip. Home Assistant still switches every outlet.
  • To remove Home Assistant, delete it under the strip’s People in the app. A linked VoltraX account can be revoked in Account → Sessions.
  • Coming from the old cloud-only Home Assistant integration (before VoltraX)? It is a different integration: add the strip here, then remove it from the old one.
Stuck on any step? Message us:WhatsAppContact us