|
| 1 | +--- |
| 2 | +title: Victron BLE |
| 3 | +description: Instructions on how to integrate Victron BLE devices into Home Assistant. |
| 4 | +ha_category: |
| 5 | + - Sensor |
| 6 | +ha_bluetooth: true |
| 7 | +ha_release: '2025.12' |
| 8 | +ha_iot_class: Local Push |
| 9 | +ha_codeowners: |
| 10 | + - '@rajlaud' |
| 11 | +ha_domain: victron_ble |
| 12 | +ha_config_flow: true |
| 13 | +ha_platforms: |
| 14 | + - sensor |
| 15 | +ha_integration_type: device |
| 16 | +--- |
| 17 | + |
| 18 | +The **Victron BLE** {% term integration %} integrates [Victron Energy](https://www.victronenergy.com/) devices that support the BLE protocol into Home Assistant. |
| 19 | + |
| 20 | +{% include integrations/config_flow.md %} |
| 21 | + |
| 22 | +The Victron BLE integration will automatically discover devices once the [Bluetooth](/integrations/bluetooth) integration is enabled and functional. |
| 23 | + |
| 24 | +## Adding a device |
| 25 | + |
| 26 | +To configure a discovered device, you will need to supply the per-device encryption key. For more information, see these [instructions](https://github.com/keshavdv/victron-ble/tree/main#fetching-keys). |
| 27 | + |
| 28 | +To get the encryption key, use the VictronConnect app ([Android](https://play.google.com/store/apps/details?id=com.victronenergy.victronconnect), [iOS](https://apps.apple.com/us/app/victron-connect/id943840744), [Linux](https://www.victronenergy.com/support-and-downloads/software#victronconnect-app), [macOS](https://apps.apple.com/us/app/victronconnect/id1084677271?ls=1&mt=12), [Windows](https://www.victronenergy.com/support-and-downloads/software#victronconnect-app)): |
| 29 | + |
| 30 | +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. |
| 31 | +2. Open the app and pair with your device. |
| 32 | +3. From the list, select the device that you want to monitor. |
| 33 | +4. To open the **Settings** for that device, select the gear icon. |
| 34 | +5. Open the menu and select **Product Info**. |
| 35 | +6. Scroll down to **Instant Readout via Bluetooth** and enable the feature (if it is not already enabled). |
| 36 | +7. To display the encryption key, next to **Instant Readout Details**, select **Show**. |
| 37 | + |
| 38 | +## Data updates |
| 39 | + |
| 40 | +This integration subscribes to passive Bluetooth updates and will update the sensors |
| 41 | +as often as the updates are received. |
| 42 | + |
| 43 | +## Removing the integration |
| 44 | + |
| 45 | +This integration follows standard integration removal. No extra steps are required. |
| 46 | + |
| 47 | +{% include integrations/remove_device_service.md %} |
0 commit comments