2026.4.0
Home ▸ Integrations

Victron BLE

The Victron BLE integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] integrates Victron Energy devices that support Instant Readout via Bluetooth (Bluetooth Low Energy, or BLE) into Home Assistant.

Supported devices

The integration supports the following Victron device types:

  • AC Charger (Blue Smart IP22, Blue Smart IP65)
  • Battery Monitor (SmartShunt, BMV series)
  • Battery Sense
  • DC-DC Converter (Orion TR Smart)
  • DC Energy Meter
  • Inverter/Charger (MultiPlus, Quattro, Inverter RS via VE.Bus)
  • Smart Battery Protect
  • Smart Lithium
  • Solar Charger (SmartSolar, BlueSolar MPPT)

Unsupported devices

The following device types are not yet supported:

  • Inverter RS (standalone, non-VE.Bus mode)
  • Lynx Smart BMS
  • Multi RS
  • Orion XS

If your device advertises via BLE with Victron manufacturer data but is not in the supported list above, it may appear in Home Assistant with only a Signal strength sensor. This is because the integration can detect any Victron BLE device, but can only read sensor data from supported device types. Full sensor data will become available when support for that device type is added.

Configuration

To add the Victron BLE device to your Home Assistant instance, use this My button:

Manual configuration steps

If the above My button doesn’t work, you can also perform the following steps manually:

  • Browse to your Home Assistant instance.

  • Go to Settings > Devices & services.

  • In the bottom right corner, select the Add Integration button.

  • From the list, select Victron BLE.

  • Follow the instructions on screen to complete the setup.

The Victron BLE integration will automatically discover devices once the Bluetooth integration is enabled and functional.

Adding a device

To configure a discovered device, you will need to supply the per-device encryption key.

To get the encryption key, use the VictronConnect app (Android, iOS, Linux, macOS, Windows):

  1. Install the VictronConnect app, ideally on the device you are using to set up this integration so you can simply cut and paste the key.
  2. Open the app and pair with your device.
  3. From the list, select the device that you want to monitor.
  4. To open the Settings for that device, select the gear icon.
  5. Open the menu and select Product Info.
  6. Scroll down to Instant Readout via Bluetooth and enable the feature (if it is not already enabled).
  7. To display the encryption key, next to Instant Readout Details, select Show.

Troubleshooting

Device only shows signal strength

If your device appears in Home Assistant but only shows a signal strength sensor, this can mean:

  • Unsupported device type: The device type is not yet supported by the integration. See the supported devices list above.
  • Incorrect encryption key: The key validation only performs a basic check. If the key is wrong but passes the initial check, the integration will be unable to decrypt the sensor data. Try removing the device and re-adding it with the correct encryption key from the VictronConnect app.

Device is not discovered

  1. Make sure Instant Readout via Bluetooth is enabled in the VictronConnect app for the device (see Adding a device above).
  2. Make sure no other device (such as a phone running VictronConnect) is actively connected to the device via Bluetooth, as this can prevent BLE advertisements from being sent.
  3. Make sure the Bluetooth integration is set up and working.

Data updates

This integration subscribes to passive Bluetooth updates and will update the sensors as often as the updates are received.

Removing the integration

This integration follows standard integration removal. No extra steps are required.

To remove an integration instance from Home Assistant

  1. Go to Settings > Devices & services and select the integration card.
  2. From the list of devices, select the integration instance you want to remove.
  3. Next to the entry, select the three dots menu. Then, select Delete.