SmartHomeEntry
Installation

Installer l’agent SmartHomeEntry

L’agent est un petit programme installé sur votre réseau local. Il ouvre une connexion sortante vers notre serveur et rend le service choisi accessible via une adresse HTTPS - sans ouvrir de ports sur votre box. Choisissez la méthode d’installation adaptée à votre matériel.

Avant de commencer

  1. Créez un compte et choisissez un forfait.
  2. Dans le tableau de bord, cliquez sur « Ajouter une installation », choisissez le système (par ex. Home Assistant) et indiquez son adresse sur le réseau local.
  3. Le tableau de bord affiche un jeton d’installation et des commandes prêtes à l’emploi qui le contiennent déjà. Le jeton est à usage unique et valable jusqu’à 30 minutes - s’il expire, générez-en un nouveau dans le tableau de bord.

Vous trouverez ci-dessous les mêmes étapes, à consulter avant l’achat. Dans les commandes, remplacez <TOKEN> par le jeton du tableau de bord.

Ajouter une installation dans le tableau de bordVoir les forfaits

Choisissez une méthode d’installation

Pour Home Assistant OS et les installations Supervised. L’agent fonctionne comme add-on : pas de terminal, pas de commandes, mises à jour directement dans l’interface HA.

  1. Ajoutez le dépôt de l’add-on

    Cliquez sur le bouton - votre Home Assistant s’ouvre avec l’adresse du dépôt déjà renseignée. Confirmez l’ajout.

    Ajouter à Home Assistant

    Ou manuellement : Paramètres → Modules complémentaires → Boutique → ⋮ (en haut à droite) → Dépôts, puis collez l’adresse :

    https://github.com/szyderca84/SmartHomeEntry-HA-Addon

  2. Installez l’add-on

    Trouvez « SmartHomeEntry Agent » dans la liste et cliquez sur Installer. S’il n’apparaît pas, rechargez la page de la boutique.

  3. Collez le jeton

    Dans l’add-on, ouvrez l’onglet Configuration et collez le jeton du tableau de bord SmartHomeEntry dans le champ install_token.

  4. Enregistrez et démarrez

    Cliquez sur Enregistrer, puis sur Démarrer dans l’onglet Infos. L’agent se connecte en quelques secondes et le tableau de bord l’affiche en ligne.

Sous Home Assistant OS, n’installez pas l’agent avec la commande curl de l’onglet Linux ni via l’add-on « Terminal & SSH » - il tourne dans un conteneur sans systemd, l’agent ne survivrait pas à un redémarrage. Vous utilisez Home Assistant Container ou Core (sans Supervisor) ? Choisissez l’onglet Docker ou Linux.

En cas de problème

Où trouver les logs

Add-on SmartHomeEntry Agent → onglet Journal (le bouton Actualiser affiche les dernières entrées). Vous y voyez si l’agent a récupéré sa configuration et établi le tunnel.

  • Le journal signale un jeton invalide ou expiré - il a déjà été utilisé ou les 30 minutes sont écoulées. Générez-en un nouveau dans le tableau de bord, collez-le dans Configuration et redémarrez l’add-on.
  • L’add-on n’apparaît pas après l’ajout du dépôt - dans la boutique, choisissez ⋮ → Rechercher des mises à jour, puis rechargez la page.
  • Le tableau de bord affiche l’agent en ligne mais l’adresse HTTPS renvoie une erreur - vérifiez l’adresse locale du service dans le tableau de bord. Elle doit être joignable depuis l’appareil où tourne l’agent (en général le port 8123 pour Home Assistant).
Code source de l’add-on sur GitHub

Pour les serveurs et NAS avec Docker (Synology, QNAP, Unraid, Linux classique) ainsi que pour Home Assistant Container. L’agent tourne dans un conteneur qui redémarre automatiquement après un reboot.

  1. Générez un jeton dans le tableau de bord

    Tableau de bord → « Ajouter une installation ». Vous obtenez la commande ci-dessous avec le jeton et l’adresse du service déjà renseignés - il suffit de la copier.

  2. Lancez le conteneur

    Sur une machine qui voit le service sur le réseau local, exécutez :

    docker run -d --name smarthomeentry-agent \
  -e SMARTHOMEENTRY_INSTALL_TOKEN=<TOKEN> \
  -e SMARTHOMEENTRY_API_URL=https://control.smarthomeentry.com \
  -e SMARTHOMEENTRY_LOCAL_ADDR=localhost:8123 \
  --network host \
  --restart unless-stopped \
  smarthomeentry/smarthomeentry-agent:latest

    SMARTHOMEENTRY_LOCAL_ADDR est l’adresse du service vue depuis cet hôte : localhost:8123 pour Home Assistant sur la même machine, ou par ex. 192.168.1.20:5000 pour un NAS du réseau.

Docker Desktop (macOS, Windows) ne prend pas en charge --network host. Supprimez cette ligne et utilisez host.docker.internal au lieu de localhost (par ex. host.docker.internal:8123).

Prérequis : Docker Engine 20+ ou Docker Desktop, accès à Internet (connexion sortante).

En cas de problème

Où trouver les logs

docker logs -f smarthomeentry-agent

Le conteneur tourne-t-il :

docker ps --filter name=smarthomeentry-agent
  • Le conteneur redémarre en boucle et le log mentionne le jeton - il a expiré ou a déjà été utilisé. Générez-en un nouveau dans le tableau de bord, supprimez le conteneur smarthomeentry-agent et relancez la commande :
    docker rm -f smarthomeentry-agent
  • Le tunnel fonctionne mais le service ne répond pas - le conteneur doit pouvoir joindre l’adresse locale. Sous Linux, gardez --network host ; sous Docker Desktop, utilisez host.docker.internal.
  • Le tableau de bord affiche l’agent en ligne mais l’adresse HTTPS renvoie une erreur - vérifiez l’adresse locale du service dans le tableau de bord. Elle doit être joignable depuis l’appareil où tourne l’agent (en général le port 8123 pour Home Assistant).
Code source de l’agent sur GitHub

Pour Debian, Ubuntu, Raspberry Pi OS, Fedora et RHEL avec systemd. Le script installe un paquet .deb ou .rpm (amd64, arm64, armhf) et un service systemd qui démarre avec le système.

  1. Générez un jeton dans le tableau de bord

    Tableau de bord → « Ajouter une installation ». Vous obtenez la commande ci-dessous avec le jeton et l’adresse du service déjà renseignés - il suffit de la copier.

  2. Lancez le script d’installation

    Collez la commande dans un terminal de l’appareil (par ex. via SSH sur un Raspberry Pi) :

    curl -sSL https://control.smarthomeentry.com/api/install/<TOKEN> | sudo bash

    Vous préférez lire ce que vous exécutez ? Téléchargez le script dans un fichier, relisez-le, puis lancez-le :

    curl -sSL https://control.smarthomeentry.com/api/install/<TOKEN> -o install.sh
less install.sh
sudo bash install.sh

  3. Terminé

    L’agent tourne en arrière-plan comme service systemd et redémarre après un reboot. Sa configuration se trouve dans /etc/smarthomeentry/agent.env.

S’il n’existe pas de paquet pour votre distribution ou architecture, le script bascule automatiquement sur Docker - consultez alors les logs comme dans l’onglet Docker. Sous macOS, le script utilise toujours Docker.

Prérequis : droits root (sudo), systemd, curl, accès à Internet.

En cas de problème

Où trouver les logs

journalctl -u smarthomeentry-agent -f

État du service :

systemctl status smarthomeentry-agent

Redémarrer le service :

sudo systemctl restart smarthomeentry-agent
  • Le script s’arrête avec « Run as root » - lancez la commande avec sudo, comme ci-dessus.
  • L’agent ne se connecte pas et le log mentionne le jeton - générez un nouveau jeton dans le tableau de bord et relancez la commande d’installation ; le script écrase la configuration.
  • Le tableau de bord affiche l’agent en ligne mais l’adresse HTTPS renvoie une erreur - vérifiez l’adresse locale du service dans le tableau de bord. Elle doit être joignable depuis l’appareil où tourne l’agent (en général le port 8123 pour Home Assistant).
Code source et paquets de l’agent sur GitHub

Toujours un problème ?

Écrivez-nous en joignant les dernières lignes du log de l’agent - c’est le moyen le plus rapide d’établir un diagnostic.

Support techniqueContactFonctionnement du tunnel et ce que nous voyons
    Installation de l’agent : Home Assistant OS, Docker, Linux | SmartHomeEntry