--- title: "Victron GX" description: "Victron GX is a built-in integration for Home Assistant. It has 3.4k installs sharing analytics and works locally." canonical: "https://vulpo.app/integrations/core/victron-gx" url: "https://vulpo.app/integrations/core/victron-gx.md" last-updated: "2026-10-22" version: "1.4" --- # Victron GX > Victron GX is a built-in integration for Home Assistant. It has 3.4k installs sharing analytics and works locally. Victron GX is a built-in integration that connects Home Assistant to Victron GX devices over the local network. It talks to the device through its MQTT port, with options for host, port, password, username and SSL use. It adds sensors, binary sensors for alarms and status, numbers for limits and generator settings, selects for modes, switches such as force charge and EV charging, and a device reboot button. A location presence entity is included as well. Home Assistant can discover the device on the network, add new devices as they appear, and remove ones that are gone. Connection settings can be changed later, and repair notices cover legacy EV charger sensors. Setup is done in the UI. Automatic summary of Home Assistant's source code. Something wrong? [Get in touch](https://vulpo.app/contact) [Open in My Home Assistant](https://my.home-assistant.io/redirect/config_flow_start/?domain=victron_gx) ## Supports - **Works locally**: Talks to your devices on your own network. No vendor cloud in between. - **Set up in the UI**: Add it in Settings, Devices and services. Nothing to download. - **Found by itself**: Home Assistant spots it on the network and offers to add it. - **Adds new devices**: New devices show up without setting it up again. - **Cleans up devices**: Devices that are gone are removed by themselves. - **Change settings later**: Its connection settings can change without removing it. - **Platinum quality**: Home Assistant's own rating of its code and setup experience. - **Updated with Home Assistant**: Ships and updates with every Home Assistant release. ## Setting it up Home Assistant usually finds it on the network and offers to add it. It can also be added by hand under Settings, Devices and services. ### Connect - **Host**: Hostname or IP address of Victron device, usually mDNS name like 'venus.local' - **Password**: Password for the Victron device, default is empty. This is not your VRM password. - **Port**: The MQTT port on the host. Normally it is 1883. - **Uses an SSL certificate**: Indicates whether to use SSL to connect to the Victron device. Normally it is disabled. - **Username**: Username for the MQTT server, default is empty. Not needed by Victron devices. This is only needed if you route your MQTT messages through a non-Victron server and it does require a username. Also asked when changing the connection. ### Authenticate Victron GX - **GX password**: Password for the Victron device, default is empty. This is not your VRM password. - **Uses an SSL certificate**: Indicates whether to use SSL to connect to the Victron device. Normally it is disabled. ### Sign in again - **Password**: Password for the Victron device, default is empty. This is not your VRM password. - **Uses an SSL certificate**: Indicates whether to use SSL to connect to the Victron device. Normally it is disabled. - **Username**: Username for the MQTT server, default is empty. Not needed by Victron devices. This is only needed if you route your MQTT messages through a non-Victron server and it does require a username. Texts from Home Assistant's source code, [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0). ## Entities - **Binary sensors**: Allow to charge, Allow to discharge, At site, Connected, High temperature alarm, High voltage alarm, High voltage AC-out alarm, Low temperature alarm, Low voltage alarm, Low voltage AC-out alarm, Overload alarm, Ripple alarm, and 6 more - **Buttons**: Device reboot - **Presence**: Location - **Numbers**: Charge current limit, AC input current limit, Max charging current, Min charging current, Charge current setpoint, Generator cooldown timer, Generator QH start on SoC, Generator QH start on voltage, Generator QH stop on SoC, Generator QH stop on voltage, Generator service interval, Generator shutdown timer, and 33 more - **Selects**: Mode, State, AC input 1 source type, AC input 2 source type, ESS mode, ESS mode (Hub4), DESS mode, VRM portal access level - **Sensors**: Load current, Consumption, Frequency, Power, Voltage, DC output current, DC output power, DC output voltage, Input current, Input power, Input voltage, State, and 214 more - **Switches**: Invert digital input, Auto start, EV charging, Auto-start enabled, Generator quiet hours enabled, Generator start on SoC enabled, Generator start on high temp enabled, Generator start on voltage enabled, Manual start, Force charge, ESS disable charge, ESS disable feed-in, and 18 more ## Troubleshooting - **Diagnostics**: Downloads a diagnostics file to attach to a bug report. - **Repair notices**: Notices it can show in Settings, Repairs: Legacy EV charger sensor removed, Legacy EV charger sensor in use ## At a glance - Kind: Built-in integration - Category: [Energy](https://vulpo.app/integrations/category/energy.md), Solar and batteries - Brand: [Victron](https://vulpo.app/integrations/victron.md) - Number: 3.4k installs sharing analytics - Connection: Works locally - Upkeep: Part of Home Assistant - Needs: Built into Home Assistant - Quality scale: Platinum quality scale - Domain: `victron_gx` - Source: In Vulpo: Quick Toggle card, Button card, Select card, Chart card, Apple Watch, Control Center ## Other ways in for Victron | Name | Kind | Installs or stars | Connection | Upkeep | | --- | --- | --- | --- | --- | | [Victron BLE](https://vulpo.app/integrations/core/victron-ble.md) | Built-in integration | 2.2k installs sharing analytics | Works locally | Part of Home Assistant | | [victron](https://vulpo.app/integrations/marketplace/sfstar-hass-victron.md) | Marketplace integration | 1.9k installs sharing analytics | Works locally | Updated in the last 6 months | | [Victron MQTT Integration](https://vulpo.app/integrations/marketplace/tomer-w-ha-victron-mqtt.md) | Marketplace integration | 1.6k installs sharing analytics | Works locally | Updated in the last 6 months | | [Victron Remote Monitoring](https://vulpo.app/integrations/core/victron-remote-monitoring.md) | Built-in integration | 1.3k installs sharing analytics | Needs the vendor's cloud | Part of Home Assistant | | [Victron VRM API](https://vulpo.app/integrations/marketplace/jayjojayson-hass-victron-vrm-api.md) | Marketplace integration | 237 installs sharing analytics | Needs the vendor's cloud | Updated in the last 6 months | Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation. [About these numbers](https://vulpo.app/integrations/about) Last updated 2026-10-22. Source: https://vulpo.app/integrations/core/victron-gx --- - HTML version of this page: https://vulpo.app/integrations/core/victron-gx - Site index for agents: https://vulpo.app/llms.txt - Everything in one document: https://vulpo.app/llms-full.txt - All pages: https://vulpo.app/sitemap.xml