Victron Cerbo GX & Venus OS VRM Troubleshooting Guide

Victron Energy's VRM (Victron Remote Management) portal provides essential monitoring and remote control capabilities for your solar energy system. When your GX device—such as a Cerbo GX, Color Control GX, or Ekrano GX—experiences connectivity issues, it can impact your ability to monitor performance, update firmware, or adjust settings remotely.

This guide outlines common VRM connectivity problems, how to resolve them, and how to use advanced diagnostic tools for your Victron GX device running Venus OS.

Prerequisites for VRM Connectivity

For your GX device to connect to the VRM portal, it must have an active internet connection.

1. Internet Connection: Connect your GX device to the internet using an Ethernet cable or a compatible WiFi module.
2. VRM Portal Access: Once connected, you can access your system's data and controls via the Victron VRM portal.

Troubleshooting Common VRM Connectivity Errors

Several error messages can indicate issues with your GX device's connection to the VRM portal or its ability to report data.

"Data from unauthenticated device has been received"

This error typically occurs when the authentication tokens between your GX device and the VRM backend are out of sync. This can happen after a factory reset or re-imaging of the GX device.

Resolution: Re-add the device to your VRM portal or ensure the VRM ID on the device matches the one registered on the portal.

Dynamic ESS Error Codes

These errors relate to the Dynamic ESS functionality and can sometimes be linked to system clock issues or configuration.

• "Dynamic ESS error code: No matching schedule available": This indicates that the system either does not have a valid schedule configured for the current timeframe or the system clock on your GX device is incorrect.
• • Resolution: Verify your GX device's time and date settings and ensure your Dynamic ESS schedules are correctly configured and active.
• "Dynamic ESS error code: ESS functionality not available": This error suggests that Dynamic ESS was previously activated on your system but is no longer in use or configured.
• • Resolution: If Dynamic ESS is no longer required, you can ignore this message. If it should be active, re-enable and configure it as needed.

Undocumented VRM Connectivity Issues

Some specific error codes and network requirements are not detailed in the available documentation.

• Error Codes #153 and #154: Specific troubleshooting steps for VRM Connectivity Error codes #153 and #154 are not provided in the current documentation.
• Firewall Outbound Ports: While internet connectivity is required, specific outbound firewall port rules for HTTPS (port 443), MQTT (port 8883), and HTTP (port 80) are not explicitly documented for VRM communication. Ensure your network allows general outbound internet traffic.

Two-Step Verification (2FA) Recovery

Two-Step Verification adds an extra layer of security to your VRM account, requiring both your password and a security code. If you lose access to your 2FA method, you can reset it.

Procedure for Resetting 2FA:

1. When attempting to log in to the VRM portal, enter your password.
2. Below the 2FA box, locate and select the option to "Reset 2 Factor Authentication".
3. Follow the prompts to reset your 2FA via an email link sent to your registered email address.

Remote Diagnostics and Management Tools

The VRM portal and Venus OS offer several tools for remote diagnostics and system management.

Remote Console

The Remote Console feature allows you to access the graphical user interface of your GX device remotely, either through the VRM portal or your local network. This is useful for checking settings and status as if you were physically in front of the device.

Remote VEConfigure

For systems with VE.Bus products (such as MultiPlus, MultiPlus-II, Quattro, or high-power inverters), Remote VEConfigure allows you to change settings remotely via the VRM Portal. This requires your GX device to be connected to the internet.

Remote Firmware Updates

You can update the firmware of internet-connected Victron products directly from the VRM Portal, provided they are connected via a GX device. This simplifies keeping your system up-to-date.

Advanced Diagnostics with SSH Access

For in-depth troubleshooting and access to system logs, you can enable SSH (Secure Shell) access on your GX device. This requires setting a temporary root password.

Procedure for SSH Access:

1. Enable Superuser Access: On your GX device, navigate to the settings and set the access level to Superuser. The default password for Superuser access is 'ZZZ'.
2. Set Temporary Root Password: Go to Settings -> General on your GX device and create a temporary root password.
3. Enable SSH on LAN: In the GX device settings, enable SSH on LAN (found under Settings -> General).
4. Connect via SSH: Use an SSH client to connect to your GX device using the command ssh root@<ip_address>, replacing <ip_address> with your GX device's IP address. Use the temporary root password you set.

This level of access is typically reserved for authorized service personnel due to the potential to alter critical system configurations.