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
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
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
Paste the invite code. Home Assistant makes its own key; it never leaves Home Assistant.
- 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
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 outletssensorPower, voltage and current, for the strip and per outletsensorEnergy, for the strip and per outlet (total increasing)numberAuto-off timer per outlet, in minutesbuttonRestart 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.