Mastering go-e Charger & Controller Integration in Home Assistant (2026 Guide)
Are you ready to unlock the full potential of your go-e Charger and turn your electric vehicle into the ultimate smart home appliance? By integrating your go-e Charger and go-e Controller into Home Assistant, you gain complete control over your EV charging, enabling everything from automated PV surplus charging to sophisticated load balancing. This comprehensive guide will walk you through the entire process for 2026, showing you exactly how to achieve maximum efficiency and savings.
⚡ Key Integration Highlights: go-e & Home Assistant
- APIv2 WebSocket Connection: Enables local, push-based real-time data updates without cloud dependencies or polling intervals.
- Solar PV Excess Automation: Automatically throttle EV charging current (6A–32A) and switch between 1-phase and 3-phase based on live solar surplus.
- Native Hardware Support: Full compatibility with go-e Charger Gemini, Home Fix, and go-e Controller hardware via HACS custom integrations.
- Advanced Load Management: Pair with Node-RED, EVCM, or PV Excess Control components for automated time-of-use tariff scheduling.
Key Takeaways
- Multiple Integration Paths: Choose from custom components, MQTT, or the APIv2 WebSocket integration to connect your go-e Charger to Home Assistant.
- PV Surplus Charging: Learn how to enable solar-only charging without needing additional hardware using smart automations.
- Full Control: Gain access to dozens of sensors and controls, including amperage limits, phase switching, and on/off toggles.
- Advanced Automation: Combine with tools like Node-RED, EVCM, and PV Excess Control for a fully automated and optimized energy ecosystem.
Integration Options for go-e Charger and Controller
When integrating your go-e hardware into Home Assistant, you have several viable options. The best choice depends on your technical comfort level and specific needs, but all methods ultimately provide robust local control without cloud dependencies.
1. go-e APIv2 WebSocket Integration (Recommended)
The most modern and efficient method is the custom integration that uses the go-e WebSocket API. Created by community developer marq24, this integration offers a local, push-based connection that provides real-time updates without polling.
| Feature | WebSocket Integration | Other Integrations |
|---|---|---|
| Data Update | Push (real-time) | Polling (interval-based) |
| API Version | v2 + WebSocket | v1 or v2 |
| Local Control | Yes | Yes |
| Setup Complexity | Moderate | Easy |
| PV Surplus Ready | Yes | Yes |
⚠️ Important Pre-requisite
Before using any of these integrations, you must enable APIv2 in the go-e mobile app. Open the app, navigate to your charger settings, and ensure the API version is set to v2. Without this step, the integrations will not work.
2. MQTT Integration
For users who already have an MQTT broker in their Home Assistant setup, this is a flexible option. The go-e charger supports MQTT natively, and you can create sensors and controls using the MQTT discovery feature. This method is particularly useful for those wanting a lightweight integration without additional custom components.
3. Custom Component (CHC0815)
The original custom component developed by CHC0815 uses the V1 API and is a good option for basic control. It provides sensors, a switch, and allows you to set the charge limit and max current. However, the WebSocket integration offers superior performance and features.
Step-by-Step Integration Guide for 2026
This guide focuses on the recommended APIv2 WebSocket integration developed by marq24, as it’s the most feature-rich for advanced users and supports all the latest go-e hardware, including the Gemini 2.0 series.
Step 1: Installation via HACS
The easiest way to install the integration is through HACS (Home Assistant Community Store).
- Open HACS in your Home Assistant sidebar.
- Click on “Integrations” and then the three-dot menu in the top right corner.
- Select “Custom repositories” and add the URL:
https://github.com/marq24/ha-goecharger-api2as an Integration. - Search for “go-e APIv2 Connect” and click Download.
- After the download completes, restart Home Assistant.
Step 2: Adding the Integration
Once restarted, go to Settings → Devices & Services. Click the “Add Integration” button and search for “go-e APIv2 Connect”. Follow the on-screen prompts:
- Select Device: Choose whether you are setting up a go-eCharger or go-eController.
- IP Address: Enter the local IP address of your go-e device.
- Password: Provide your go-e charger password to enable the real-time WebSocket connection.
Step 3: Enabling WebSocket for Real-Time Updates
To get the fastest, most responsive data, ensure WebSocket communication is active. The integration will automatically use this if you provided a password during setup. This mode makes the polling interval obsolete and delivers instant updates when your charger or car status changes.
Optimizing with PV Surplus Charging
One of the most powerful features unlocked by this integration is PV surplus charging. You can configure automations to dynamically adjust your EV’s charging current based on your available solar energy, ensuring you charge your car using 100% renewable energy.
The go-e APIv2 integration supports this directly. By combining it with a grid export/import sensor in Home Assistant, you can create a feedback loop that adjusts the amperage in real-time.
“PV surplus charging allows your go-e wallbox to be controlled digitally via the internet, making additional hardware unnecessary for most setups.”
Creating Template Sensors for Solar Surplus
To effectively use your solar power, you need a sensor that calculates the available surplus. Advanced users often create template sensors like these from the Node-RED community flow:
Surplus Including Battery:
{% set pv = states('sensor.total_dc_power') | float %}
{% set haus = states('sensor.load_power') | float %}
{% set batterie = states('sensor.battery_charging_power') | float %}
{% set wallbox = states('sensor.go_echarger_247529_nrg_12') | float %}
{% set ueberschuss = pv - haus - batterie + wallbox %}
{{ ueberschuss | round(1) }}Surplus Ignoring Battery (Priority to EV):
{% set pv = states('sensor.total_dc_power') | float %}
{% set haus = states('sensor.load_power') | float %}
{% set wallbox = states('sensor.go_echarger_247529_nrg_12') | float %}
{% set ueberschuss = pv - haus + wallbox %}
{{ ueberschuss | round(1) }}These sensors can then be used in automations to increase or decrease the charging current.
Advanced Control and Automation Examples
Controlling the Charger
Once integrated, you’ll have access to a wealth of entities:
- Switch:
switch.charger_force_charging– Start or stop charging. - Number:
number.charger_max_current– Adjust the amperage (6-32A). - Select:
select.phase_switch_mode– Control phase switching (Auto, Force single phase, Force three phases). - Sensors: Access over 20 sensors including car status, energy consumed, power in each phase, and internal temperature.
Example Automation: Dynamic PV Surplus Charging
This basic automation (using Node-RED or a similar tool) adjusts the charging current based on solar surplus:
- Trigger: Every 30 seconds or when the surplus sensor changes.
- Condition: Car is plugged in and solar surplus is positive.
- Action: Calculate the maximum allowable current based on the surplus and call the service
goecharger_api2.set_max_currentto update the charger.
Troubleshooting: Access Control and RFID
Some users set up an RFID card authorization in the go-e app. If your charger is locked, you might need to control the “card authorization required” switch. Turning this switch off within Home Assistant effectively acts as a software “unlock,” allowing the car to charge without physically presenting an RFID card.
Advanced Energy Management with Other Integrations
For a more holistic energy management system, consider combining your go-e integration with these powerful solutions:
EVCM (EV Charging Manager)
This HACS integration is designed specifically to manage EV charging. It can handle multiple chargers, prioritize them, and use dynamic current control based on grid import/export, ensuring you never draw from the grid during peak prices or when solar production is low.
PV Excess Control
Developed by InventoCasa, this sophisticated integration offers a “24-hour forward-looking optimizer with weather-aware pre-planning.” It can manage multiple appliances, including your EV charger, based on solar forecasts, battery SoC, and even tariff pricing from providers like Tibber or Awattar.
Frequently Asked Questions: go-e Charger Home Assistant Integration
How do I enable APIv2 on my go-e Charger for Home Assistant?
Open the official go-e mobile app, connect to your charger settings, navigate to the API options, and enable local APIv2 and WebSocket access. This allows Home Assistant to receive real-time push updates.
Does Home Assistant integration require internet or cloud access for go-e Chargers?
No. The go-e Charger Home Assistant integration communicates locally over your home Wi-Fi or LAN network via local HTTP/WebSocket APIs, ensuring 100% cloud-independent local control.
Can Home Assistant automatically switch phase modes on go-e Chargers?
Yes. The APIv2 integration exposes the phase switch entity, enabling Home Assistant automations to seamlessly toggle between 1-phase (for low solar output) and 3-phase (for peak solar or fast charging).
Conclusion
Integrating your go-e Charger and go-e Controller into Home Assistant is one of the most impactful smart home upgrades you can make in 2026. Whether you want to achieve the holy grail of 100% solar-powered driving or simply want to better manage your energy consumption, the tools are readily available and community-supported. With multiple integration paths and advanced automation options, you have complete control over your EV charging ecosystem.
Start by installing the recommended APIv2 WebSocket integration via HACS, map your sensors, and build automations that save you money and reduce your carbon footprint. The future of smart, sustainable EV charging is here.
