Victron Remote Monitoring
The Victron Remote Monitoring (VRM) integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] pulls site statistics, solar production and consumption forecasts from Victron Energy
Prerequisites
-
VRM access token (keep this secret!). Create one in the VRM Portal under Preferences > Integrations > Access tokens or use this link
. - Access to your site(s) with the account used to create the token.
Forecast requirements
- VRM installation with a solar system and all consumption routed through inverters or a grid meter.
- At least 30 days of data in VRM before forecasts appear.
Your VRM access token grants full access to your VRM portal, including system control and data retrieval. Treat it like a password:
-
Do not share it.
-
Rotate it immediately if you suspect compromise.
Configuration
To add the Victron Remote Monitoring service 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.
-
In the bottom right corner, select the
Add Integration button. -
From the list, select Victron Remote Monitoring.
-
Follow the instructions on screen to complete the setup.
Setup notes
- When prompted, paste your VRM access token.
- After validation, the integration automatically fetches the list of sites available to that token.
- Select your site from the dropdown and finish the setup.
Data updates
The VRM integration fetches fresh data from the VRM API every 60 minutes.
Sensor entities
Solar production forecast
- Estimated energy production — Yesterday
- Estimated energy production — Today
- Remaining production — Today
- Estimated energy production — Tomorrow
- Production — Current hour
- Production — Next hour
- Peak production time — Yesterday
- Peak production time — Today
- Peak production time — Tomorrow
Consumption forecast
- Estimated energy consumption — Yesterday
- Estimated energy consumption — Today
- Remaining consumption — Today
- Estimated energy consumption — Tomorrow
- Consumption — Current hour
- Consumption — Next hour
- Peak consumption time — Yesterday
- Peak consumption time — Today
- Peak consumption time — Tomorrow
Troubleshooting
Can’t set up authentication
Symptom: “Invalid authentication”
Description
This usually means that the token used is invalid or expired.
Resolution
Verify that you’re logged in with the correct VRM account, then try the following steps:
- Log in to the VRM portal and under Preferences > Integrations > Access tokens (or use this link
), remove the current token if present. - Generate a new token by selecting Add on the same page, enter the token name, leave the expiry date empty, and select Create token.
- Copy and paste the newly generated token into Home Assistant. Follow the setup instructions.
No sites listed during setup
Symptoms: Empty dropdown, “No sites found for this account” or “Site ID not found. Please check the ID and try again.”
Description
The integration could not find any sites or installations associated with your account.
Resolution
Verify that you’re logged in with the correct VRM account and that you have permission to access the desired sites or installations.
Can’t find sensors
Symptom: Sensors are unavailable or missing
Description
The integration cannot retrieve forecast data.
Resolution
- Check the logs and the Settings > Devices & services page for any errors.
- Check if you still have permission to access the desired site or installation.
- If you reset or just set up the VRM Forecasts, there might be a delay of up to 30 days before data appears.
Removing the integration
This integration follows standard integration removal.
To remove an integration instance from Home Assistant
- Go to Settings > Devices & services and select the integration card.
- From the list of devices, select the integration instance you want to remove.
- Next to the entry, select the three dots
menu. Then, select Delete.
After deleting the integration, go to the VRM Portal under Preferences > Integrations > Access tokens or use this link