Guides d'installation → Agent Sunplug → Docker

Agent Sunplug sur Docker

Pour un NAS ou un mini-PC qui fait déjà tourner des conteneurs et reste allumé.

Le lancer

L'image est publiée pour x86 et ARM. La machine doit être sur le même réseau que votre onduleur.

docker run -d --name sunplug-agent --network host \
  -v sunplug-agent:/data --restart unless-stopped \
  sunplugapp/sunplug-agent:latest

Ouvrez ensuite http://<machine>-agent.local:8787 depuis un navigateur de votre réseau, où <machine> est le nom d'hôte de la machine, ou utilisez son adresse IP. La page trouve votre onduleur.

Enphase, visible ici, demande une connexion unique. Fronius, SolarEdge, SolaX, Sungrow, GoodWe, LuxPower, APsystems, SMA, KOSTAL, Hoymiles, OpenDTU et Victron n'en demandent aucune. Le guide de votre marque précise ce qui s'applique.

Un bouton « rechercher et installer » de NAS omet --network host, nécessaire pour trouver votre onduleur, et le volume /data, nécessaire pour garder l'appairage d'une mise à jour à l'autre.

Compose

Sur un NAS avec Compose ou Projets — Synology, QNAP, UGREEN — ceci règle les deux pour vous :

services:
  agent:
    image: sunplugapp/sunplug-agent:latest
    network_mode: host
    restart: unless-stopped
    volumes:
      - agent_data:/data
volumes:
  agent_data:

Appairage

Dans l'application, Réglages → Équipement → Ajouter un agent affiche un code à six caractères. Saisissez-le sur la page de configuration de l'agent.

Le code est à usage unique et expire au bout d'une heure. Chaque agent peut être révoqué séparément depuis les Réglages, qui indiquent aussi quand il s'est manifesté pour la dernière fois.

Mettre à jour

Rien ne se met à jour tout seul. L'application vous prévient quand une nouvelle version de l'agent est disponible.

Sur un NAS

Cherchez re-pull, rebuild ou redéployer :

• UGREEN (UGOS) — Docker → Projet → votre projet → ⋯ → Paramètres → Configuration Compose → Redéployer, cochez Récupérer la dernière image, puis Déployer
• Synology — Container Manager → Vue d'ensemble signale les mises à jour disponibles ; pour un projet, Projet → Action → Générer, qui re-télécharge et recrée
• QNAP — Container Station → Images → Pull (sunplugapp/sunplug-agent, tag latest), puis Vue d'ensemble → Modifier l'application → Appliquer sans rien changer
• Asustor — Portainer ou Docker Engine → Images → Pull, puis recréez le conteneur
• TrueNAS SCALE — Apps → l'application → Update, ou modifiez et enregistrez pour re-télécharger une app personnalisée
• Unraid — onglet Docker → Check for Updates → appliquer
• Portainer (tout NAS) — ouvrez le conteneur → Re-pull image → Recreate

Docker ou Compose

docker compose pull && docker compose up -d

Ou, sans Compose :

docker pull sunplugapp/sunplug-agent:latest
docker rm -f sunplug-agent
docker run -d --name sunplug-agent --network host \
  -v sunplug-agent:/data --restart unless-stopped \
  sunplugapp/sunplug-agent:latest

L'appairage est stocké dans le volume /data : il est conservé.

Vérifier que ça marche

docker logs -f sunplug-agent

Une ligne toutes les trente secondes, du genre pv=2.62kW grid=-0.31kW load=2.31kW soc=0.47, et l'indicateur de fraîcheur du tableau de bord stabilisé à quelques secondes.

Quand ça ne marche pas

Rien trouvé sur le réseau

La machine est sans doute sur un autre segment que l'onduleur — Wi-Fi invité ou VLAN IoT. Saisissez l'adresse à la main dans le champ sous la liste, sur la page de configuration.

Il dit qu'il n'est pas configuré

L'agent n'est pas encore appairé : ouvrez sa page de configuration et saisissez le code affiché dans l'application.

« L'accès de cet agent a été révoqué »

Il a été supprimé depuis Réglages → Équipement. Appairez-le à nouveau avec un code neuf.

Le tableau de bord affiche encore les données du cloud

Dès qu'un agent alimente Sunplug, celui-ci cesse d'interroger le cloud de votre fabricant. La page Équipement l'indique.

Bloqué ? Écrivez-moi avec la sortie des journaux.