2025.10.3
Home ▸ Integrations ▸

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’s VRM portal into Home Assistant. It provides day-ahead, next-hour, and six-day outlooks for both production and consumption. It also includes peak-time predictions. The integration requires at least 30 days of VRM history before forecasts become available.

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.

Important

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.

  • Go to Settings > Devices & Services.

  • 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

  1. When prompted, paste your VRM access token.
  2. After validation, the integration automatically fetches the list of sites available to that token.
  3. 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:

  1. Log in to the VRM portal and under Preferences > Integrations > Access tokens (or use this link), remove the current token if present.
  2. Generate a new token by selecting Add on the same page, enter the token name, leave the expiry date empty, and select Create token.
  3. 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

  1. Check the logs and the Settings > Devices & services page for any errors.
  2. Check if you still have permission to access the desired site or installation.
  3. 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

  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.

After deleting the integration, go to the VRM Portal under Preferences > Integrations > Access tokens or use this link to remove the token.

Related links