# Enphase-Envoy-MQTT

Enphase-Envoy-MQTT is a self-hosted home automation app. Unraid community template for home automation users that wraps Enphase-Envoy-mqtt-json to publish real-time Enphase Envoy gateway data to MQTT, with optional Victron Cerbo GX / Venus OS integration examples. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/2789/enphase-envoy-mqtt

## Description

Unraid community template for home automation users that wraps Enphase-Envoy-mqtt-json to publish real-time Enphase Envoy gateway data to MQTT, with optional Victron Cerbo GX / Venus OS integration examples.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

41/100 (Fair), based on 3 of 4 factors.
- Maintained: 70 (last commit 77 days ago)
- Popular: 0 (0 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- Unraid: https://ca.unraid.net/apps/enphase-envoy-mqtt-1xc0uye0pqclc2?q=Enphase-Envoy-MQTT

## Common questions

### Does this Unraid template require an MQTT broker, and can the broker run outside the Unraid server?

Yes, it requires a running MQTT broker. The broker can be any MQTT service reachable from the Unraid server, including a local broker, a remote MQTT server, or the MQTT broker on a Victron Cerbo GX.

### Do I need to open inbound ports or run a web interface for the Enphase-Envoy-MQTT container?

No, the container does not require a web UI or inbound ports. It connects outbound to the Envoy over HTTPS and publishes the JSON data to MQTT.

### Is Victron Cerbo GX or Venus OS hardware required to use the optional Victron integration examples?

No, the Victron hardware is not required. The examples are optional and work by sending Enphase data through MQTT, with Node-RED creating virtual meters in the Victron setup.

### Do I have to edit the upstream options.json file manually when deploying the Unraid template?

No, the Unraid wrapper automatically generates the upstream options.json from the Unraid environment variables. It also keeps a persistent Enphase authentication token.

### Will my Enphase credentials or authentication token appear in container logs?

No, Enphase credentials and authentication tokens are redacted from application logs.

---
Source: Our Local Host (https://ourlocalhost.com/app/2789/enphase-envoy-mqtt), the self-hosted and open-source app directory.
