SSD Nodes Learn Hosting plans →
Guides Matt ConnorPar Matt Connor

Accéder à son agent Hermes depuis un smartphone

Découvrez comment connecter votre agent Hermes sur VPS à votre téléphone via un réseau maillé ou un reverse proxy sécurisé. Apprenez à révoquer les accès en cas de perte.

Les trois façons d’accéder à votre agent Hermes depuis votre téléphone

Pour accéder à votre agent Hermes depuis votre téléphone, vous utilisez son tableau de bord web. Le vrai choix concerne donc ce qui se trouve devant ce tableau de bord. La première option est un réseau maillé privé. Le tableau de bord écoute uniquement sur une adresse Tailscale et aucun port n’est exposé sur Internet. La deuxième option est un endpoint public derrière un reverse proxy avec TLS (transport layer security) et une authentification. Cette authentification est alors la seule protection d’un terminal donnant accès à votre serveur. La troisième option est SSH (secure shell) depuis une application de terminal. C’est la solution qui demande le moins de configuration, mais qui fournit le niveau d’accès le plus élevé.

Ce guide commence là où se termine l’exécution d’un agent Hermes sur votre propre VPS. L’agent est installé, il répond sur la ligne de commande et vous voulez maintenant y accéder depuis votre téléphone.

Les commandes ci-dessous utilisent le tag v2026.8.3, publié le 3 août 2026 et identifié comme v0.20.0 dans les notes de version. Hermes publie souvent de nouvelles versions. Épinglez donc la machine sur un tag au lieu de suivre main. L’installateur accepte un commit :

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/v2026.8.3/scripts/install.sh | bash -s -- --commit 3c27eb6234bf
hermes --version

Utilisez l’installateur de ce tag pour effectuer cette épinglage. L’installateur actuel attend le nouveau système de dépendances PM. hermes --version affiche ce qui est réellement installé. Comparez-le avec le tag avant de faire confiance à un flag présenté sur cette page.

Ce que le dépôt fournit et ce qu’il ne fournit pas

Le dépôt Hermes ne contient aucune application iOS ou Android. Le client natif est hermes desktop (alias hermes gui), une application Electron pour macOS, Windows et Linux. Il peut se connecter à un agent distant au lieu d’utiliser un agent local : définissez l’URL distante sur http://<server-address>:9119 dans Settings, sous Gateway, ou exportez HERMES_DESKTOP_REMOTE_URL=http://<server-address>:9119 avant de le lancer. Cela permet d’utiliser un deuxième ordinateur portable. Cela ne sert pas pour un téléphone.

Depuis un téléphone, vous utilisez hermes dashboard, l’interface du navigateur. Elle permet de gérer la configuration, les sessions, les tâches cron, les skills, les logs et les plateformes de messagerie. Elle intègre aussi un terminal : le serveur lance hermes --tui derrière un PTY (pseudo-terminal), puis transmet la sortie dans la page. Sur un écran étroit, le sélecteur de session se replie dans un panneau coulissant. La mise en page reste donc utilisable sur un téléphone.

Les versions plus récentes proposent également l’espace de travail Desktop dans un navigateur via hermes webapp. Il s’agit d’une surface Gateway distincte, avec son propre port et ses propres paramètres d’URL publique. Les instructions ci-dessous concernent le dashboard.

Par défaut, le dashboard écoute sur 127.0.0.1:9119 et ouvre un onglet du navigateur directement sur le serveur. Cela ne sert à rien sur un VPS (virtual private server) headless. Démarrez-le sans ouvrir le navigateur et examinez le socket :

hermes dashboard --no-open
ss -lntp | grep 9119

Un listener sur 127.0.0.1:9119 est accessible uniquement depuis le serveur. Un listener sur 0.0.0.0:9119 est accessible depuis tous les réseaux auxquels la machine est connectée, y compris le réseau public. Cette seule ligne détermine votre niveau d’exposition. Lisez-la au lieu de le supposer.

Option 1 : un réseau mesh privé avec Tailscale

Choisissez cette option, sauf si vous avez une raison de ne pas le faire. Tailscale est un VPN mesh (virtual private network) basé sur WireGuard. Chaque appareil que vous inscrivez reçoit une adresse stable et se connecte directement aux autres appareils ou par l’intermédiaire d’un relais chiffré. Votre téléphone rejoint le même réseau mesh. Le dashboard n’a donc jamais besoin d’un port public.

Sur le serveur :

curl -fsSL https://tailscale.com/install.sh | sh
sudo tailscale up
tailscale ip -4

Installez l’application Tailscale sur le téléphone et connectez-vous avec le même compte. tailscale status sur le serveur affiche ensuite le téléphone par son nom. Liez maintenant le dashboard à l’adresse affichée par tailscale ip -4 :

hermes dashboard --host 100.101.102.103 --port 9119 --no-open

Lier le service à l’adresse du réseau mesh plutôt qu’à 0.0.0.0 signifie que le socket n’accepte que les connexions destinées à cette adresse IP du mesh. Un scan de votre adresse IP publique ne trouve rien sur 9119, car aucun service n’écoute sur cette adresse. Cela ne lie toutefois pas le socket à l’interface Tailscale. La documentation du noyau Linux l’explique clairement : les adresses IP appartiennent à l’hôte complet, et non à des interfaces particulières. Un paquet destiné à 100.101.102.103 et arrivé par l’interface publique, envoyé par une machine du même réseau du fournisseur, peut donc encore atteindre le dashboard. Pour imposer également l’interface, laissez ufw avec son refus par défaut du trafic entrant et autorisez le port uniquement sur le mesh avec sudo ufw allow in on tailscale0 to any port 9119 proto tcp. Vérifiez de nouveau le service en écoute avec ss -lntp | grep 9119.

L’adresse d’écoute détermine également l’authentification. C’est le point souvent oublié. Dans v2026.8.3, un dashboard lié à 127.0.0.1 n’a aucune connexion même lorsque public_url est configuré. Sur toute autre adresse, la barrière d’authentification est obligatoire. Si aucun provider n’est configuré, le serveur refuse de démarrer. Le projet appelle cela un échec fermé. Lancez-le en mode interactif la première fois. Il vous propose alors de définir un nom d’utilisateur et un mot de passe, enregistrés immédiatement sous dashboard.basic_auth dans ~/.hermes/config.yaml. Vous pouvez aussi configurer le même provider via ~/.hermes/.env, comme dans l’exemple de configuration fourni par le projet :

HERMES_DASHBOARD_BASIC_AUTH_USERNAME=you
HERMES_DASHBOARD_BASIC_AUTH_PASSWORD_HASH=scrypt$16384$8$1$...
HERMES_DASHBOARD_BASIC_AUTH_SECRET=a-long-random-string

Générez ce secret avec openssl rand -base64 32, la commande utilisée dans la documentation du dashboard du projet. Le commentaire de configuration demande au moins 32 octets aléatoires, en base64 ou en hexadécimal. Ne le modifiez ensuite plus. Il signe les jetons de session du provider de mots de passe. Le modifier déconnecte donc tous les appareils qui utilisent ce provider. Le même fichier contient vos clés d’API de modèle. Protégez-le donc avec chmod 600 ~/.hermes/.env.

Vérifiez la barrière depuis une autre machine du mesh avant de lui faire confiance :

curl -s http://100.101.102.103:9119/api/status | jq '.auth_required, .auth_providers'

true suivi de ["basic"] signifie que la barrière est active et que le provider de mots de passe répond. La documentation du projet est catégorique à propos de ce provider : il est prévu pour un réseau de confiance ou un VPN, et ne convient pas à un dashboard exposé sur Internet. Avec un réseau mesh, c’est exactement votre situation.

Pour utiliser HTTPS à l’intérieur du tailnet, la configuration Tailscale Serve ci-dessous nécessite une version plus récente prenant en charge public_url dans les vérifications Host et WebSocket Origin. Elle ne fonctionne pas avec le pin v2026.8.3 : un bind sur loopback n’accepte que les noms Host de loopback, quelle que soit la valeur de public_url. Avec ce pin, restez sur l’adresse IP directe du mesh indiquée plus haut. Après la mise à niveau et la vérification de ces contrôles, Serve transmet les requêtes à l’adresse loopback. Pour cette configuration, démarrez donc le dashboard sur 127.0.0.1 plutôt que sur l’adresse du mesh, puis :

sudo tailscale serve --bg localhost:9119
sudo tailscale serve status

La documentation actuelle du dashboard Hermes indique ensuite d’utiliser comme URL publique l’origine HTTPS affichée par tailscale serve status :

dashboard:
  public_url: "https://vps.tail1234.ts.net"

Sans cette ligne, le dashboard refuse le nom MagicDNS dans l’en-tête Host. Comme ce nom n’est pas un hôte loopback, la barrière d’authentification reste également active, même si le backend écoute sur loopback. Tailscale termine TLS avec un certificat émis pour le nom MagicDNS de la machine. Le navigateur n’affiche donc plus d’avertissement et le cookie de session reçoit son attribut Secure. Activez d’abord MagicDNS et les certificats HTTPS sur la page DNS de la console d’administration Tailscale. Profitez-en pour lire l’avertissement : les noms de vos machines et le nom DNS de votre tailnet sont publiés dans le registre public de transparence des certificats, que tout le monde peut consulter.

Le coût réel concerne le serveur de coordination. Le trafic entre votre téléphone et votre VPS est chiffré de bout en bout, y compris lorsqu’il passe par un relais Tailscale DERP. En revanche, le compte qui détermine quels appareils appartiennent au réseau mesh n’est pas hébergé sur votre matériel. Si cela pose problème, exécutez vous-même le control plane avec Headscale, le serveur de contrôle Tailscale auto-hébergé, et indiquez-le aux clients avec tailscale up --login-server https://headscale.example.com. Si vous préférez abandonner le mesh et configurer les pairs manuellement, la comparaison entre WireGuard classique et Tailscale explique ce que vous perdez.

Option 2 : un endpoint HTTPS public et le piège qu’il contient

Un mesh n’est pas toujours disponible. Un téléphone professionnel peut interdire l’installation d’un client VPN. Le dashboard passe alors derrière un reverse proxy. Cette configuration HTTPS sur loopback nécessite également la prise en charge plus récente des noms d’hôte publics décrite plus haut ; public_url ne la rend pas opérationnelle sur v2026.8.3. Conservez le dashboard sur loopback et laissez Caddy gérer le certificat :

hermes.example.com {
  reverse_proxy 127.0.0.1:9119
}

Caddy récupère et renouvelle le certificat automatiquement. Son reverse_proxy transmet les upgrades WebSocket sans directive supplémentaire, ce dont le terminal intégré du dashboard a besoin. Avec nginx, vous devez ajouter vous-même les en-têtes Upgrade et Connection. La section émettre un certificat Let’s Encrypt avec Certbot sur nginx couvre la partie TLS de cette configuration. Indiquez à Hermes son nom public afin que les callbacks de connexion pointent vers le bon hôte :

dashboard:
  public_url: "https://hermes.example.com"

Voici le piège. La gate d’authentification se base sur l’adresse d’écoute, et non sur l’adresse d’origine de la requête. Les releases actuelles activent également la gate lorsque dashboard.public_url (ou HERMES_DASHBOARD_PUBLIC_URL) désigne un hôte qui n’est pas en loopback, même si le backend écoute sur loopback. Le paramètre ci-dessus active donc la gate et le dashboard refuse de démarrer tant qu’un provider n’est pas configuré. Laissez public_url non défini pour désactiver la gate. Mais le proxy ne contrôle pas à lui seul les accès. Le dashboard vérifie aussi l’en-tête Host. Dans cette configuration sur loopback, les releases actuelles acceptent les noms de loopback et l’hôte déclaré par public_url. Pour toute autre valeur, elles répondent avec une erreur 400. La version épinglée v2026.8.3 n’accepte ici que les noms de loopback et ne vérifie jamais public_url. Caddy transmet sans modification le Host du navigateur. Le bloc ci-dessus, sans public_url, est donc rejeté et non servi. Le danger vient d’un proxy qui réécrit Host vers l’adresse du backend. nginx le fait exactement par défaut : il envoie la cible proxy_pass, sauf si vous définissez vous-même proxy_set_header Host. Une telle requête passe la vérification et atteint un dashboard sans connexion. Le WebSocket du terminal ajoute une vérification Origin : dans la version épinglée, un en-tête HTTP ou HTTPS Origin, lorsqu’il est présent, doit cibler l’hôte lié. Cela bloque un navigateur utilisant votre nom d’hôte public. En revanche, un script qui n’envoie aucun Origin passe cette vérification. Quelle que soit votre configuration, vérifiez ce que vous avez réellement publié :

curl -s https://hermes.example.com/api/status | jq '.auth_required'

Si cette commande affiche false, Internet est à une URL d’un terminal sur votre serveur. Aucun exploit n’est nécessaire et rien ne l’indiquera dans les journaux. Si la requête échoue avec une erreur 400, la vérification Host l’a refusée. Avec une release qui prend en charge les noms d’hôte publics, corrigez le problème en définissant public_url et un provider de connexion, et non en réécrivant les en-têtes pour contourner la vérification. Sur v2026.8.3, utilisez la route directe via l’IP du mesh ou procédez d’abord à une mise à niveau. Deux solutions permettent de sécuriser un dashboard ouvert. Vous devez en appliquer au moins une. Vous pouvez soit placer l’authentification dans le proxy, avec Authentik comme provider SSO auto-hébergé devant celui-ci via forward auth, soit configurer le provider OIDC (OpenID Connect) du dashboard :

HERMES_DASHBOARD_OIDC_ISSUER=https://auth.example.com/application/o/hermes/
HERMES_DASHBOARD_OIDC_CLIENT_ID=hermes-dashboard
HERMES_DASHBOARD_OIDC_SCOPES="openid profile email"

Même correctement configurée, cette option impose une limite que vous ne pouvez pas réduire. Une page de connexion publique est accessible et attaquable par n’importe qui. Elle protège un shell sur votre VPS. Un nom d’utilisateur et un mot de passe offrent une protection limitée dans ce contexte. C’est pourquoi la documentation recommande OAuth ou OIDC pour les binds publics. Limitez le débit des connexions, gardez ufw fermé à tout sauf aux ports du proxy et à SSH, et consultez de temps en temps le journal d’accès.

Option 3 : SSH et mosh depuis un terminal mobile

La solution qui demande le moins d’efforts consiste à installer une application de terminal sur le téléphone, à y charger une clé SSH, puis à utiliser l’interface texte de l’agent.

ssh you@vps.example.com
tmux new -A -s phone
hermes --tui

tmux new -A -s phone se rattache à une session appelée phone, ou la crée si elle n’existe pas. L’agent continue ainsi de fonctionner lorsque la connexion est interrompue, et vous retrouvez le même environnement à la prochaine connexion. Le principe est le même que celui utilisé pour piloter Claude Code depuis un téléphone.

Un SSH standard sur un réseau mobile est peu pratique, car la connexion est interrompue dès que le téléphone change d’adresse ou se met en veille. Mosh résout ce problème. Il utilise UDP (user datagram protocol) et synchronise l’état du terminal au lieu de transmettre un flux d’octets. La session survit ainsi au passage du wifi au réseau cellulaire :

sudo apt install -y mosh
sudo ufw allow 60000:61000/udp

Depuis le téléphone, exécutez mosh you@vps.example.com. Mosh démarre mosh-server via votre connexion SSH existante, puis transfère la session vers un port UDP compris entre 60000 et 61000. C’est pourquoi il faut ouvrir cette plage. Chaque session n’utilise qu’un seul port. Sur un serveur qui compte peu de sessions simultanées, vous pouvez donc ouvrir une plage plus réduite, par exemple de 60000 à 60010.

Le coût en matière de sécurité est simple. Une session SSH fournit un shell, et un shell permet d’effectuer toutes les opérations autorisées pour ce compte. Les demandes d’approbation de l’agent sont alors le dernier obstacle entre un téléphone déverrouillé volé et vos fichiers. Utilisez un compte non-root dédié à cette tâche, avec une authentification par clé uniquement, et appliquez les recommandations de durcissement de SSH sur un VPS avant de placer une clé sur un appareil que vous transportez avec vous.

Ce qui ne fonctionne pas sur un réseau mobile

Quatre problèmes se produisent, et aucun ne peut être résolu par un simple réglage.

Le dashboard vous déconnecte pendant que vous ne le consultez pas. Le délai dépend du fournisseur d’authentification. Le fournisseur basé sur un nom d’utilisateur et un mot de passe émet un access token valable 12 heures par défaut. Cette durée est définie par session_ttl_seconds sous dashboard.basic_auth, mais elle contrôle uniquement la fréquence à laquelle le dashboard s’actualise en arrière-plan, pas la durée de votre session. Chaque actualisation génère un nouveau refresh token valable 30 jours. Une connexion par mot de passe reste donc valide tant qu’aucune actualisation ne manque pendant 30 jours. Un redémarrage du backend met également fin à la session si aucun secret de signature stable n’est configuré via HERMES_DASHBOARD_BASIC_AUTH_SECRET ou dashboard.basic_auth.secret, car Hermes génère alors une nouvelle clé de signature à chaque démarrage. Le fournisseur OAuth Nous Portal émet des access tokens avec un TTL (time to live) de 15 minutes et les renouvelle en arrière-plan avec un refresh token qui change à chaque utilisation. Un access token arrivé à expiration ne vous renvoie donc pas à lui seul vers /login. Ce qui provoque ce retour, c’est la perte de la session de renouvellement. Dans les releases antérieures à v0.21.3 (tag v2026.9.14, publié le 14 septembre 2026), un téléphone sortant de veille pouvait envoyer plusieurs requêtes simultanément, réutiliser le refresh token qui venait de changer, déclencher la détection de réutilisation du fournisseur et faire révoquer toute la session. Vous reveniez alors à l’écran de connexion et le texte en cours de saisie était perdu. v0.21.3 regroupe ces requêtes autour d’un seul renouvellement. Du côté de Nous Portal, une session de renouvellement prolonge désormais sa période de 30 jours à chaque changement, mais 30 jours d’inactivité suffisent toujours à y mettre fin. Si vous utilisez le pin v2026.8.3 indiqué en haut de cette page, prévoyez une demande de connexion occasionnelle. Rien n’est cassé. Reconnectez-vous.

Le terminal intégré ne résiste pas par défaut à une mise en arrière-plan de l’onglet. La connexion au terminal documentée par le dashboard lance la TUI (text user interface) derrière un PTY et la ferme proprement lorsque l’onglet est fermé. Sa réouverture en lance une nouvelle. Les navigateurs mobiles suppriment les onglets en arrière-plan pour récupérer de la mémoire. Passer suffisamment longtemps à une autre application met donc fin à ce terminal. L’historique de vos conversations est conservé, car les sessions sont stockées sur le serveur et hermes sessions list les affiche toujours. Le serveur utilisé comme référence prend également en charge, sur activation explicite, une connexion keep-alive avec un attachment token. Celle-ci conserve un PTY détaché pendant 30 minutes. Si vous avez besoin d’une session qui résiste à cette mise en arrière-plan, utilisez tmux via SSH.

Les connexions inactives se ferment silencieusement. Les opérateurs mobiles suppriment les connexions TCP inactives pour libérer des entrées dans leurs tables NAT (network address translation). Lorsque l’écran est éteint, le téléphone cesse presque entièrement de traiter le trafic réseau. Un WebSocket resté silencieux pendant un certain temps est généralement déjà fermé lorsque vous déverrouillez le téléphone. La page ne se reconnecte qu’après une interaction. C’est pourquoi mosh est plus agréable que SSH sur un téléphone : il n’avait jamais de connexion à perdre.

Aucune notification n’est envoyée. Ni le dashboard ni une session SSH ne peuvent sortir votre téléphone de veille. Aucune application Hermes n’est installée sur l’appareil. Il n’existe donc aucun chemin vers le service de push de la plateforme. Une longue exécution d’agent se termine, et vous ne le découvrez que lorsque vous consultez à nouveau le téléphone.

Les notifications passent par la passerelle de messagerie

La solution à ce dernier problème consiste à utiliser la passerelle, qui offre un autre moyen d’atteindre l’agent. hermes gateway connecte l’agent à des plateformes de messagerie comme Telegram, Discord, Slack, WhatsApp, Signal et la messagerie électronique. Vous dialoguez ensuite avec votre agent dans une application qui dispose déjà d’un canal push sur votre téléphone, gère déjà la livraison en arrière-plan et supporte déjà les interruptions réseau.

hermes gateway setup
hermes gateway install
hermes gateway status

hermes gateway install enregistre la passerelle comme service systemd, afin qu’elle redémarre après un reboot. L’étape gateway de l’installateur peut effectuer cette opération, mais l’installateur ne crée aucune unité pour hermes dashboard. Le dashboard ne redémarrera donc pas automatiquement après un redémarrage. Créez une unité pour chaque composant dont vous dépendez. La page écrire des services et des timers systemd sur un VPS décrit le fichier lui-même.

Une tâche planifiée peut envoyer un résultat de la même manière, sans conversation :

hermes send -t telegram -s "Backup report" -f /home/you/report.txt

L’autorisation applique ici un refus par défaut. Sans allowlist, sans appairage approuvé et avec GATEWAY_ALLOW_ALL_USERS non défini, tous les utilisateurs sont refusés. C’est le comportement initial recommandé. Indiquez dans ~/.hermes/.env les comptes que vous autorisez :

TELEGRAM_ALLOWED_USERS=123456789
GATEWAY_ALLOWED_USERS=123456789

Vous pouvez aussi utiliser un appairage par code au lieu de coller des identifiants numériques. C’est le comportement par défaut pour les plateformes de DM de type chat. Vous pouvez l’activer explicitement avec unauthorized_dm_behavior: pair dans ~/.hermes/config.yaml. Lorsqu’un compte inconnu envoie un message à l’agent, il reçoit un code de huit caractères. Rien d’autre ne se produit tant que vous ne l’avez pas approuvé :

hermes pairing list
hermes pairing approve telegram ABC12DEF
hermes pairing revoke telegram 123456789

Les codes expirent au bout d’une heure. Un utilisateur peut en demander un toutes les dix minutes. Cinq tentatives échouées bloquent ce compte.

Limiter l’impact d’un téléphone volé

Un téléphone qui peut atteindre votre agent peut exécuter des commandes sur votre serveur, et les téléphones se perdent. Décidez maintenant de ce que la personne qui le détient pourra faire.

Laissez les approbations activées. approvals.mode vaut smart par défaut : il demande à un modèle auxiliaire d’évaluer le risque et n’approuve automatiquement que les commandes à faible risque. Le définir sur off revient à tout exécuter avec --yolo, et HERMES_YOLO_MODE=1 fait la même chose via l’environnement. Ne transportez pas un téléphone qui communique avec un agent dans cet état. Définissez approvals.cron_mode: deny afin que les tâches planifiées ne puissent pas s’approuver elles-mêmes pendant votre sommeil.

approvals:
  mode: smart
  cron_mode: deny

Réduisez la portée des actions que l’agent peut effectuer. terminal.backend: docker exécute les commandes dans un conteneur qui supprime toutes les capabilities Linux, sauf une courte liste, définit no-new-privileges et limite le nombre de processus. Le conteneur devient ainsi la frontière de sécurité, plutôt qu’une simple invite. terminal.cwd fixe le répertoire de travail. HERMES_WRITE_SAFE_ROOT limite write_file et patch aux répertoires que vous indiquez. Toute écriture en dehors de ces répertoires est bloquée, sans possibilité de la valider.

export HERMES_WRITE_SAFE_ROOT=/home/you/projects:/home/you/.hermes

Hermes bloque déjà les écritures vers ~/.ssh, ~/.aws, ~/.kube et /etc/sudoers, ainsi que vers ses propres stockages de secrets tels que ~/.hermes/.env. Les fichiers .env du projet situés ailleurs sur le disque ne peuvent pas être lus, mais restent accessibles en écriture. Hermes refuse également une liste stricte de commandes destructrices, quels que soient vos paramètres d’approbation. Considérez cela comme un niveau minimal de protection, pas comme votre stratégie. Exécutez l’agent avec un utilisateur ordinaire, jamais avec root. Le même raisonnement s’applique à tout coding agent laissé en fonctionnement sans surveillance, et exécuter Claude Code en toute sécurité sur un VPS l’explique plus en détail.

Notez ensuite les étapes de révocation avant d’en avoir besoin. La suppression de l’appareil dans la console d’administration Tailscale coupe immédiatement l’accès au mesh. La modification de HERMES_DASHBOARD_BASIC_AUTH_SECRET, suivie d’un redémarrage, invalide toutes les sessions des dashboards des password providers sur tous les appareils, car cette valeur signe les tokens de session du provider. La suppression de la clé publique du téléphone dans ~/.ssh/authorized_keys bloque les nouvelles connexions SSH avec cette clé ; terminez séparément les sessions SSH et mosh existantes. hermes pairing revoke telegram <user-id> supprime un compte de messagerie. Si l’appareil contenait quoi que ce soit permettant de lire les clés de votre provider, révoquez-les avec hermes auth logout <provider> et créez-en de nouvelles auprès du provider.

Vérifiez le résultat au lieu de le supposer. Exécutez ces commandes sur votre propre machine. Leur sortie dépend de votre configuration :

tailscale status
hermes pairing list
hermes logs gateway -n 100
hermes status --deep

Les journaux se trouvent sous ~/.hermes/logs/. Consultez-les après un incident et consultez-les régulièrement lorsqu’il n’y en a pas eu.

FAQ

Existe-t-il une application mobile Hermes officielle pour iOS ou Android ?

Non. Le dépôt Hermes fournit une interface en ligne de commande, un tableau de bord web et un client de bureau Electron pour macOS, Windows et Linux. Il n’existe pas de version iOS ou Android officielle. Depuis un téléphone, utilisez le tableau de bord web dans un navigateur, un client SSH ou une plateforme de messagerie connectée via hermes gateway. Des clients mobiles tiers existent également. Ils utilisent vos identifiants pour accéder à votre agent. Lisez donc leur code source avant d’en installer un.

Pourquoi le tableau de bord Hermes me déconnecte-t-il sur mon téléphone ?

Cela dépend du fournisseur d’authentification. Le fournisseur OAuth Nous Portal émet des access tokens avec un TTL de 15 minutes et les renouvelle en arrière-plan avec un refresh token rotatif. Un access token expiré ne vous redirige donc pas vers /login. Dans les releases antérieures à v0.21.3 (tag v2026.9.14), un téléphone revenant de l’arrière-plan pouvait envoyer plusieurs requêtes simultanément, réutiliser le refresh token qui venait d’être renouvelé et révoquer toute la session. Cela force alors une nouvelle connexion. v0.21.3 corrige ce problème, mais une session de refresh restée inactive pendant 30 jours expire toujours. Le fournisseur utilisant un nom d’utilisateur et un mot de passe définit par défaut un access token de 12 heures, configuré par session_ttl_seconds. Ce paramètre contrôle uniquement la fréquence à laquelle le tableau de bord se rafraîchit en arrière-plan. Le renouvellement utilise un refresh token de 30 jours, réémis à chaque refresh. Une connexion par mot de passe ne se termine donc pas après 12 heures. Avec ce fournisseur, définissez HERMES_DASHBOARD_BASIC_AUTH_SECRET sur une valeur aléatoire stable. Si cette variable ou dashboard.basic_auth.secret ne contient pas de secret stable, Hermes génère une nouvelle clé de signature à chaque démarrage. Chaque redémarrage vous déconnecte alors.

Puis-je exposer le tableau de bord Hermes sur Internet en toute sécurité ?

Uniquement avec une authentification que vous avez vous-même vérifiée. Le mécanisme d’authentification s’active selon l’adresse d’écoute et, dans les releases actuelles, lorsque dashboard.public_url désigne également un hôte qui n’est pas une adresse loopback. Ainsi, un tableau de bord lié à 127.0.0.1 derrière un reverse proxy, sans URL publique configurée, ne demande jamais de connexion. Dans le pin v2026.8.3, définir public_url n’active ni le mécanisme d’authentification loopback ni l’accès via un nom d’hôte public dans les vérifications Host et WebSocket Origin. Utilisez la route directe par IP mesh ou mettez à niveau Hermes vers une release prenant en charge les noms d’hôte publics avant de suivre la configuration du proxy HTTPS. Sa vérification Host bloque un proxy qui transmet votre nom d’hôte public, mais pas un proxy qui réécrit Host avec l’adresse du backend, comme nginx le fait par défaut. Exécutez curl -s https://your-host/api/status | jq '.auth_required' et lisez le résultat. Utilisez OAuth ou OIDC plutôt qu’un nom d’utilisateur et un mot de passe, car la documentation du projet indique que le fournisseur par mot de passe est destiné aux réseaux de confiance et aux VPN. Un mesh privé évite entièrement ce problème. C’est donc le meilleur choix par défaut.

Ai-je besoin d’un compte Tailscale ou puis-je auto-héberger le control plane ?

Vous pouvez l’auto-héberger. Headscale est une implémentation ouverte du serveur de coordination Tailscale. Les clients Tailscale officiels s’y connectent avec tailscale up --login-server https://headscale.example.com. Vous contrôlez alors la liste des appareils autorisés à rejoindre le mesh. En contrepartie, vous devez exploiter et sauvegarder ce serveur. Lorsqu’il est indisponible, vous ne pouvez pas inscrire un appareil ni réauthentifier un appareil existant.

Comment recevoir une notification sur mon téléphone lorsque l’agent termine une tâche ?

Utilisez la messaging gateway. Le tableau de bord et SSH ne peuvent pas réveiller un téléphone, car aucun appareil Hermes n’est installé pour recevoir des notifications push. Connectez l’agent à Telegram, Signal, Discord ou une autre plateforme prise en charge avec hermes gateway setup, puis laissez l’application de cette plateforme distribuer la notification. Une tâche cron peut également envoyer un message unique avec hermes send -t telegram -s "Job done" -f /path/to/report.txt. Cette méthode envoie le message sans appeler le modèle.

Cet article vous a-t-il été utile ?