Enphase wont connect: Can someone help me troubleshoot?

I recently installed solar with an Enphase Envoy - and I cannot seem to get it into Home Assistant. Home Assistant auto-discovers the system with the IP address but when I try and configure I get this error message “Cannot connect: (500, ‘Unable to connect to Envoy’)”.

Some facts:

  • Home Assistant version: 2025.12.5
  • Enphase Firmware: D8.2.4401
  • Enlighten, envoy.local, and the ip address from my browser all work just fine

Any help would be appreciated!

Is the Envoy on wired, WIFI, or both (which it shouldn’t)?

If you add

logger:
  default: warning
  logs:
    homeassistant.components.enphase_envoy: debug
    homeassistant.components.zeroconf: debug

to your configuration.yaml there will be debug details in the log file that may provide some more detail on what is going on.

Today, after trying this new fewer than 10 times over the past 2 days, it decided to work… Lets see if it stays stable and connected

Okay - So I am starting to get closer to the source of the issue (which is different from what I thought) but not 100% what is going on. After connecting this morning it was active for about 30 minutes and then went unavailable. I get the following in my logs:

2026-01-07 12:03:06.364 DEBUG (MainThread) [homeassistant.components.enphase_envoy.coordinator] update on try 0, EnvoyError aiohttp ClientError Cannot connect to host 192.168.XX.XXX:443 ssl:default [Connect call failed ('192.168.XX.XXX', 443)]
2026-01-07 12:03:06.364 DEBUG (MainThread) [homeassistant.components.enphase_envoy.coordinator] Finished fetching Envoy XXXX data in 17.698 seconds (success: False)

When I use my browser, I can get it to just fine at that IP address, but I cant ping it from Home Assistant. I can also ping it just fine from the host (I have HASS running on Proxmox)

The error is what is says, connection failed. Now the envoy is known in HA, you can enable debug on the integration page so there may be more details in the log as with above settings in the configuration file.

I’m not familiar with proxmox, ran into it in a very long topic on a proxmox instance once that didn’t want to connect either and did not get to a resolution.

In the topic you may find some leads or not. My pickup from it is that the network part needs to be done right. But I admit I have no knowledge on it so don’t ask how or what. (And I may be completely off track here.) Your browser is probably a different platform as the HA instance, so there may be differences in it.