Integrate your Enphase Gateway (Envoy) for solar panel monitoring and control. Monitor live power production, daily and lifetime energy yields, and connected microinverters. Also adds the ability to turn off your solar array, disabling power production during negative energy prices.
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.
Instructions for getting Maintainer (Control) access to your Enphase system:
-
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.
-
Once done with that, login to Enlighten as the owner.
-
Go to Menu ā Account ā My access control.
-
Find:
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.)
-
After granting access, right below that youāll find a āPV system maintainerā pull down. Select your fake company there.
-
Now youāll see something like this on the page:
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.)
-
The login for your fake company is the login you use in the Enphase Controller app.
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!
@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?
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/
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
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.
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.
Does this work with the metered gateway as well?
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.
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?
Not sure what you mean there. But it is the correct link:
(thereās currently no test-version)
Yes, I managed to make the āfakeā account via the app.
Solved, fix by Athom fw v13.2.2 for (Pro) 2016-2019 models
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
Awesomeā¦ Man, we spent some hours on this 
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
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 
How about this, he knew already, but didnāt report unfortunately:
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.
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 
Quick preview (very much alpha fase):
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.
Same situation over here. It was working for a couple of days and now not any more
@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?
