[APP][Pro] Enphase Controller

Apps
,
1

Monitor solar production, grid import and export, home consumption, individual microinverters, and battery power and charge level of your Enphase systems. The Energy Flow widget animates live power between solar, grid, home, and battery. Battery monitoring is read-only; solar production can be controlled.

This app integrates well into the Energy tab and utilizes the latest Homey energy related features.

Monitoring and control features depend on gateway hardware, account access, and installed consumption clamps; the app will detect this automatically. See the community “Visit forum”-link below.

image
image613×1335 68 KB
image
image378×829 40.4 KB

Real-time monitoring works with any Enphase energy system, regardless of the account type. However, you need a linked Installer, Maintainer, or DIY/Self-Installer account to toggle the system on or off.

Note that for unmetered Envoy gateways, a power ON or OFF command will take about 30 minutes to fully propagate to all microinverters.

image
image1929×650 107 KB

Instructions for getting Maintainer (Control) access to your Enphase system

  1. Register as a (fake) company with Enphase here. Make sure you pick the first option (company!). Pick a funny name for your fake company, use a fake VAT number, and use a different email than the one you used for your (normal) owner account.

  2. Once done with that, login to Enlighten as the owner.

  3. Go to Menu → Account → My access control.

  4. Find:

    image
    image570×158 7.39 KB

    and enter the email you used for your fake company.
    (Right above this thing you’ll already see the name/company of your actual installer by the way. Remember that.)

  5. After granting access, right below that you’ll find a “PV system maintainer” pull down. Select your fake company there.

  6. Now you’ll see something like this on the page:

    image
    image256×122 5.3 KB

    Verigo, my actual installer, is still there.
    WolfSolar (my fake company) is now registered as the maintainer.

    (Notice the delete buttons. With a few clicks you can revert the whole situation if needed. If you’re ever contacting your original installer (for help/warranty), I’d advise to remove yourself as maintainer here first and make sure the original installer is the maintainer again. That way they have remote access to your system once again.)

  7. The login for your fake company is the login you use in the Enphase Controller app.

Changelog

2.0.2 - Oct 22, 2026 (currently in test)

Widget visual update.
Widget now supports external sources.
Adds widget settings for min/max power.

2.0.1 - Oct 19, 2026 (test only)

Shows solar power per phase (optional).
Shows grid power and voltage per phase (optional).
Shows home power per phase (optional).
Fixes daily energy resetting at wrong time.

2.0.0 - Oct 12, 2026 (test only)

This release reworks several internal systems for more reliability and future updates. Unfortunately some devices will have to be re-added.
Adds Enphase battery monitoring.
Adds animated energy flow widget (only for metered systems).
Homey alarm support for inverter problems.
Adds deprecation notices to timeline for older drivers.
Adds French and German language support.
Support for unwired production meters.

1.5.3 - Aug 15, 2026 (test only)

Adds an “Always on” setting.
Removes unused legacy Envoy device driver.

1.5.2 - Jun 27, 2026

Fixes production limit errors.
Improves meter detection.

1.5.1 - Jun 25, 2026

Tests production limiting support.
Falls back to standard control.
Fixes rapid control changes.

1.5.0 - Jun 23, 2026

Adds solar production limiting.
Enables net export limits.

1.4.0 - Jun 18, 2026

More consistent device naming and setting grouping.

1.3.6 - Jun 17, 2026

Adds home electricity usage monitoring.
Tracks grid imports and exports.
Improves pairing wizard dark mode.

1.3.5 - Jun 15, 2026

Added support for metered gateway readings.

1.3.4 - Jun 12, 2026

Improved authentication stability.

1.3.3 - Jun 9, 2026

Improved login troubleshooting.

1.3.2 - Jun 9, 2026

Configure underperforming inverter threshold.
Instant feedback clearing alerts.

1.3.1 - Jun 7, 2026

Fix bug in authentication flow.

1.3.0 - Jun 7, 2026

Monitors individual solar microinverters.
Alerts when panels are underperfoming or go offline.
Improved gateway IP & SN detection.

1.2.1 - Jun 3, 2026

Prevents negative night-time solar readings.
Replaces default icons.

1.2.0 - May 30, 2026

Adds “Energy today” (kWh) status metric.
More reliable gateway connection.
More reliable pairing process.
Improved compatibility with other Enphase apps.
Improved gateway connection stability.
More readable device names
Reduced memory and cpu usage.

1.1.0 - May 28, 2026

Updates app store descriptions and marketing images.
Restores compatibility with Homey Pro 2019 models.
Plays nicely with other installed Enphase apps.
Clarifies owner vs. installer control levels during pairing.
Renames status metrics to “Active inverters” and “Control access”.
Adds “Metered gateway” status indicator.
Validates gateway connection before completing pairing.
Offers manual IP fallback if automatic discovery fails.
Supports local IPv6 networks.
Fixes status polling for System Owner accounts.
Supports switching between System Owner and Installer/DIY accounts.

1.0.0 - May 26, 2026

Initial release.

Get it here

Public test version is here (if there is one).

Kind reminder: if you’re trying the normal or test-version of the app and run into a bug, unexpected behavior or just something weird; please send an app Diagnostic Report through homey within 15 minutes (so I get the detailed logs) and put a few keywords in the description to let me know what exactly I’m looking for. Thank you!

2

@microkid You had some connectivity and control access problems before, right? Could you try the new test version?

@Peter_Kawa Can you try installing the new test version on your pro 2019?

3

Hi Bram,

Unfortunately it doesn’t install yet.
The app store status message is as usual: “Enphase Controller will install on Homey shortly”,
however, the blue LED ring rotates just a sec, which is too short during app installs.
The app doesn’t appear.
Just to be sure, I unplugged Homey 15 minutes before installing.

Just to compare with a few random apps:
The https://homey.app/en-nl/app/org.xojs.panelenvoy/IQ-Insights/ app doesn’t install; it shows the same symptoms;

These apps install fine https://homey.app/en-nl/app/io.nuki/Nuki/, and https://homey.app/en-nl/app/it.diederik.solar/Solar-Panels/

4

treath from tweakers enphase.

Bedoel je dat je 'm af en toe offline zag gaan in 1.1, of juist in 1.2.1?

PS. Er is een topic op het Homey forum. Dan hoeven we hier dit draadje niet zo te kapen.

yes with version 1.1 saw it offlline sometimes

5

Ah yes ok, this is fixed/improved in 1.2 in various ways:

  • The gateway has fairly slow processor and might sometimes take a bit longer to respond to requests coming from Homey. The timeout on that request has been increased.
  • If the gateway still doesnt respond in time, or can’t be reached for whatever reason (e.g. wifi problems), the app will silently retry for about 30 minutes. Only after 30 minutes it will report to Homey that something is wrong.
  • In the meantime the app is actively monitoring the local network; if the gateway has been moved to a different IP it will show up in the local mDNS records and the app will silently adopt the new gateway IP. (The same mechanism that will auto-detect the gateway IP when adding the device.)

Let me know if you still get random offline (or other) errors. If so, please send an app Diagnostic Report.

1.2.1 has just been released.

6

Added my Envoy (non-metered) and worked first try!
Used my installer account (which also has the solar panel system of my dad).
I don’t have MFA (SMS) enabled which was a problem with the official Enphase app for Homey.

7

Does this work with the metered gateway as well?

8

Yep! The measurements will be even faster in that case as we dont have to rely on the inverters reporting to the gateway. Toggling the system on/off will also be much quicker even (~30 seconds instead of ~30 minutes) compared to unmetered gateways.

Upcoming versions will also add support for Production Export Limiting… instead of turning the system on/off you can limit the solar power production to a specific wattage. This will only be available to metered gateways though (and this is why the metered-detection is already present).

So yes, metered is better even.

9

I’m trying right now, but the link in the first post redirects to the enlighten manager of me as a user. Is that the correct link?

10

Not sure what you mean there. But it is the correct link:

(there’s currently no test-version)

11

Yes, I managed to make the ‘fake’ account via the app.

12

Solved, fix by Athom fw v13.2.2 for (Pro) 2016-2019 models

13

I have 2 gateways with different user accounts, can I access both with 1 fake installer account? And will I be able to see both gateways seperate in Homey? Thanks

14

Awesome… Man, we spent some hours on this :sweat_smile:

I think, yes. Add the same fake company as maintainer for both systems.
Then just add two gateway’s with the same credentials, but different gateway serials. In theory, it should work. In the advanced settings there’s an “Include in energy report”. Leave it both on ‘true’ and Homey will add them together on the Energy page.

If you run into problems, send me an app Diagnostic Report

15

A few nights indeed, my sweet lord in heaven hahaha. But all with pleasure, Bram.

I learned a thing or two, and I’m still (more) convinced I’m less and less interested in writing some [heavily swearing] Homey apps :rofl::rofl::rofl:

How about this, he knew already, but didn’t report unfortunately:

Screenshot_20260606_002848_Slack
Screenshot_20260606_002848_Slack1025×325 83.2 KB

16

Just installed the app. The app accepted the credentials, i am a installer now.
But now, at 00:43, on the tile is a button for on/off. Should that be on or off or is it automaticly turning on when the solar panels are starting up? It is not necessary to turn it off for now when the sun is shining.

17

No, just think of it as a regular on/off switch for the entire system that you control; it will be in the position that you set it and remain there.

The switch is there to give you the ability to turn the power production off at the times when you don’t want it. For example, when the electricity rates become negative and putting power back into the grid actually costs you money, and you get paid for using electricity.

Ah well.. I’m still having fun; i’m just happy that thing got solved – it was taking way to much time.

I’m working on 1.3 now, which adds the ability to monitor every individual inverter/panel, together with stats and notices/triggers/alarms. The codebase more than doubled already :expressionless:

Quick preview (very much alpha fase):

image
image790×133 14.7 KB

image
image355×772 36.4 KB

18

Thanks.
I installed the app and looked it up this morning. Device not available. Restart of the app did not help. I see all the icons, but no values. After a short amount of time it says unavailable.
Maybe it is because i have another Enphase app also working on the same Homey. The app Enphase.

19

Same situation over here. It was working for a couple of days and now not any more

20

@Mike1233 I received a Diagnostic Report yesterday, what that you?
In any case, what I’ve noticed is that the app can lose its authenticated session suddenly when other Enphase apps are present. It looks like the Envoy/gateway isn’t designed to have multiple authenticated sessions active. I’ve made this app less aggressive and made sure I’m only using 1 active session to minimize the impact on other Enphase apps. But other apps can still have an impact on this app.
This situation isn’t handled very properly in the current version, that will be fixed in the next. Note I can only improve how the app handles situations like this. I can’t do anything about the Envoy session limit though. Running multiple Enphase apps together might just be inherently unstable.

@Steven_Bareman Are you also running another Enphase app? Can you send me a Diagnostic Report?