Home Assistant Integrations

EG4 Web Monitor

Complete Home Assistant integration for EG4 solar inverters, batteries, and GridBOSS systems

EG4 Electronics is a leading manufacturer of residential and commercial solar energy equipment. Their product line includes high-performance solar inverters (FlexBOSS series, 18KPV, 12KPV, XP series), advanced battery storage systems with integrated Battery Management Systems (BMS), and GridBOSS microgrid interconnection devices that enable seamless integration with utility power.

Powered by pylxpweb

Integration Features

Monitor and control your complete solar energy system from Home Assistant.

Real-time Monitoring

Track power generation, battery state of charge, grid usage, voltage, current, temperature, and energy production in real-time

Device Control

Control operating modes, enable quick battery charging, activate battery backup (EPS) mode, and configure charge limits

Multi-Device Support

Manage multiple solar installations, inverters, batteries, and GridBOSS devices from a single account

Available Sensors & Controls

Real-time visibility into every aspect of your solar, battery, and grid power.

Inverter Sensors

  • AC power output
  • Battery charge/discharge power
  • State of charge (SOC)
  • Daily energy generation
  • Grid frequency & voltage

Battery Sensors

  • State of charge percentage
  • Individual cell voltages
  • Battery temperature
  • Charge/discharge current

GridBOSS Sensors

  • Grid power import/export
  • Load power consumption
  • Smart port status
  • Operating mode

Control Entities

  • Quick charge switch
  • Battery backup (EPS) switch
  • Operating mode selection
  • Charge limit configuration

Advanced Home Assistant Automations

Without this integration, systems operate in isolation with only basic scheduled behaviors. Home Assistant integration unlocks sophisticated automation capabilities:

Dynamic Time-of-Use Optimization

Automatically adjust battery charge/discharge behavior based on utility rate schedules. Charge batteries during off-peak hours and discharge during peak pricing periods to maximize savings.

Example: "When electricity rates enter peak period (4pm-9pm), discharge battery to power home and avoid grid usage. When rates drop to off-peak (midnight-6am), switch to quick charge mode to fully charge batteries."

Weather-Aware Energy Management

Integrate with weather forecasts to preemptively adjust energy storage strategy. Prepare for cloudy days by maintaining higher battery reserve, or allow deeper discharge when sunny weather is forecasted.

Example: "If tomorrow's forecast shows low solar production, maintain battery SOC above 80% tonight. If next week shows consistent sun, allow battery to discharge to 20% to maximize solar utilization."

Intelligent Load Management

Coordinate high-power appliances with solar production and battery status. Automatically delay or trigger energy-intensive tasks based on available renewable energy and battery capacity.

Example: "Start EV charging when solar production exceeds 3kW and battery is above 50%. Pause pool pump if battery drops below 30% and grid power is expensive. Run dishwasher and laundry during peak solar production hours."

Grid Outage Response

Automatically activate battery backup mode during grid outages and send notifications. Prioritize critical loads and manage power consumption to extend battery runtime.

Example: "When grid power lost, activate EPS mode, send push notification, turn off non-essential loads (pool, HVAC), adjust thermostat to conserve battery, and calculate estimated backup runtime based on current load."

Installation & Support

Home Assistant (HACS)

Recommended for users

Install directly from HACS (Home Assistant Community Store). This is the easiest method and provides automatic update notifications.

Add to Home Assistant

Opens My Home Assistant to add the repository directly

Manual Installation

1Open Home Assistant and navigate to HACS
2Search for 'EG4' in the Integrations section
3Click Download and wait for installation to complete
4Restart Home Assistant and add the integration from Settings → Devices & Services

Python Library

For developers

For developers building custom integrations or scripts, the underlying Python library is available on PyPI.

pip install pylxpweb
View on PyPI

Requirements

  • Home Assistant 2025.11.0 or newer
  • Active EG4 Monitor account (https://monitor.eg4electronics.com)
  • EG4 inverter, battery, or GridBOSS device connected to EG4 Monitor

Source Code

View the source code, report issues, or contribute to the project on GitHub.

View on GitHub

Open Source & Community Driven

This integration is an unofficial, open-source project developed by the Home Assistant community. It is not affiliated with or endorsed by EG4 Electronics. The integration is actively maintained with regular updates to support new EG4 products and features. Community contributions and feature requests are welcome on GitHub.

EG4 Web Monitor Integration | JoyfulHouse