Guide d’installation d’AgentVera Runner

Ce que fait Runner

Utilisez Runner quand vous voulez que les agents tournent sur un serveur puissant et toujours allumé plutôt que sur votre portable. Runner conserve les sessions de terminal des agents sur ce serveur : fermez le capot, perdez votre connexion ou connectez-vous depuis un autre ordinateur, la session continue.

• Le code et les conversations restent sur votre serveur.
• La connexion est relayée par le serveur AgentVera via TLS chiffré ; le trafic de terminal relayé n’y est ni interprété, ni journalisé, ni stocké.
• Vous voyez l’utilisation du CPU, de la mémoire et du disque du serveur, les sessions ouvertes et les fichiers des dossiers que vous autorisez.
• Pour les tâches issues de webhooks ou de « Send to agent » sur le web, la fin de la sortie de l’agent (jusqu’à 6 000 caractères) est transmise au serveur comme résumé de la tâche à la fin de son tour.

Prérequis

• Un serveur ou un ordinateur sous Linux ou macOS.
• Node.js 20 ou version ultérieure, et npm.
• curl ou wget.
• Pour les sessions d’agent, un CLI installé et connecté sur ce serveur : Claude Code, Codex, Gemini CLI ou opencode. Les sessions de terminal fonctionnent toujours.
• Une organisation AgentVera avec l’offre Pro ou Team.

Si Node.js est absent, installez-le depuis nodejs.org ou avec fnm :

curl -fsSL https://fnm.vercel.app/install | bash && fnm install 22

Pour installer Claude Code et vous connecter une première fois :

npm install -g @anthropic-ai/claude-code
claude login

Installation

1. Ouvrez app.agentvera.dev/runners dans votre navigateur et cliquez sur « Yeni runner ekle » (ajouter un runner). Un code d’association de 8 caractères apparaît ; il est valable 10 minutes.
2. Exécutez la commande ci-dessous sur votre serveur en remplaçant KOD par votre code d’association.
3. En quelques secondes, le runner apparaît en ligne sur /runners. Ouvrez-le pour voir l’utilisation du CPU, de la mémoire et du disque, et lancez une session Claude, Codex ou terminal avec « Yeni ajan » (nouvel agent).

curl -fsSL https://app.agentvera.dev/runner/install.sh | sh -s -- --pair KOD

Si le code d’association a expiré, il suffit d’en créer un nouveau sur /runners.

Options de l’installateur

Ajoutez ces options à la commande d’installation :

• --name NAME : le nom du runner. Par défaut, le nom d’hôte de la machine.
• --server URL : le serveur AgentVera. Par défaut https://app.agentvera.dev.
• --no-service : n’installe pas de service en arrière-plan, si vous n’utilisez le runner que depuis l’application de bureau via SSH.

curl -fsSL https://app.agentvera.dev/runner/install.sh | sh -s -- --pair KOD --name build-server

Ce que fait l’installateur

• Installe Runner dans ~/.agentvera-runner/app (un dossier que vous seul pouvez ouvrir) et relie la commande en tant que ~/.local/bin/agentvera-runner.
• Sous Linux avec systemd, crée un service utilisateur nommé agentvera-runner qui redémarre tout seul s’il s’arrête.
• Sans systemd, Runner démarre en arrière-plan et écrit ses journaux dans ~/.agentvera-runner/runner.log ; après un redémarrage du serveur, vous le relancez à la main.
• Sous macOS, installe un agent launchd nommé dev.agentvera.runner qui démarre à l’ouverture de session, redémarre s’il s’arrête et écrit ses journaux dans ~/.agentvera-runner/runner.log.
• Enregistre le jeton d’accès dans un fichier que vous seul pouvez lire.

Sous Linux, pour que Runner continue de tourner après votre déconnexion, exécutez ceci une fois :

sudo loginctl enable-linger $USER

Ligne de commande

agentvera-runner status               # version, service, association, serveur et dossiers autorisés
agentvera-runner roots ~/projects      # limite les agents et l’accès aux fichiers à ces dossiers
agentvera-runner pair KOD --name NAME  # associer à nouveau
agentvera-runner daemon                # exécute Runner au premier plan

Sans roots, les agents travaillent dans votre dossier personnel. Après une nouvelle association, redémarrez le service ; Runner se connecte au démarrage.

Gérer le service

Linux (systemd) :

systemctl --user status agentvera-runner
systemctl --user restart agentvera-runner
systemctl --user stop agentvera-runner
journalctl --user -u agentvera-runner -f

macOS (launchd) :

launchctl unload ~/Library/LaunchAgents/dev.agentvera.runner.plist   # stop
launchctl load -w ~/Library/LaunchAgents/dev.agentvera.runner.plist   # start
tail -f ~/.agentvera-runner/runner.log

Se connecter depuis l’application de bureau

La page Runner de l’application de bureau AgentVera se connecte aux runners de deux façons : via le cloud avec le même compte, ou directement via un serveur SSH enregistré. Si vous utilisez SSH, vous pouvez installer avec --no-service ; l’application démarre elle-même Runner lors de la connexion.

Désinstallation

1. Supprimez le runner sur app.agentvera.dev/runners. Son jeton est révoqué immédiatement et il ne se reconnecte plus.
2. Arrêtez et supprimez le service.
3. Supprimez les fichiers de Runner.

# Linux
systemctl --user disable --now agentvera-runner
rm ~/.config/systemd/user/agentvera-runner.service

# macOS
launchctl unload ~/Library/LaunchAgents/dev.agentvera.runner.plist
rm ~/Library/LaunchAgents/dev.agentvera.runner.plist

# both
rm -rf ~/.agentvera-runner ~/.local/bin/agentvera-runner

Sécurité

• Runner n’ouvre que des connexions sortantes ; vous n’avez pas besoin d’ouvrir de ports ni de modifier le pare-feu.
• Seuls les membres actifs de votre organisation peuvent voir le runner et s’y connecter. Le personnel du support qui consulte le compte en tant qu’utilisateur ne peut pas s’y connecter.
• Les connexions ouvertes sont fermées pour les utilisateurs dont l’adhésion prend fin ou dont l’organisation est suspendue.
• Utilisez roots pour définir les dossiers auxquels les agents et l’accès aux fichiers sont limités.
• Les tâches déclenchées par webhook peuvent envoyer des prompts au runner ; ne connectez que des sources de confiance.

Dépannage

• « Node.js 20 ya da üstü gerekli » (Node.js 20 ou ultérieur requis) : installez Node.js 22 et relancez la commande.
• Code d’association invalide : ses 10 minutes sont peut-être écoulées ; obtenez un nouveau code sur /runners.
• Le runner n’apparaît pas en ligne : vérifiez la sortie de agentvera-runner status et les journaux ; assurez-vous que le serveur peut joindre app.agentvera.dev:443.
• Un type d’agent manque sous « Yeni ajan » : installez ce CLI sur le serveur et connectez-vous ; Runner ne liste que les agents qu’il trouve installés.