Auto-héberger KiroCrew sur un VPS, toujours disponible
Déployez KiroCrew en container versionné sur votre VPS : Docker, systemd, accès SSH, sauvegardes et rollback pour conserver mémoire et tâches après un reboot.
Pourquoi auto-héberger KiroCrew sur un VPS plutôt que sur un ordinateur portable
L’auto-hébergement de KiroCrew n’est utile que sur une machine qui ne se met jamais en veille. Un VPS est donc l’environnement adapté, contrairement à un ordinateur portable. KiroCrew conserve l’historique des sessions, la mémoire sémantique, les tâches planifiées et la file d’approbation sur le disque. Il recharge toutes ces données au redémarrage du processus. Rien de tout cela ne sert si le processus n’est pas en cours d’exécution à 03:00, au moment où une tâche planifiée doit démarrer. Or un ordinateur portable fermé n’exécute pas KiroCrew.
KiroCrew est un workspace d’agent open source de l’équipe Kiro, distribué sous licence Apache 2.0, avec 0.1.0 publié le 22 juillet 2026. Un seul processus, appelé gateway, gère l’état et fournit un tableau de bord web sur le port 5476. Vous accédez à cette gateway depuis le tableau de bord, depuis la CLI kirocrew ou depuis un canal de discussion tel que Slack. La gateway est le seul composant que vous auto-hébergez. Ce guide explique donc comment la maintenir en fonctionnement, la garder hors de l’Internet public et la restaurer après une mise à niveau défectueuse.
Deux points doivent être connus avant de commencer. Depuis 0.11.0, les nouvelles installations de KiroCrew sans choix de harness enregistré utilisent KAS par défaut, sans nécessiter kiro-cli. Les sélections explicites de Kiro CLI existantes sont conservées. L’inférence sur les backends Kiro utilise votre forfait Kiro. Au 1 novembre 2026, cette configuration par défaut ne fonctionne donc pas hors ligne. Le projet est également récent et évolue rapidement : ses versions stables sont passées de 0.1.3 le 5 août 2026 à 0.10.0 le 25 octobre 2026, avec 0.8.0 le 9 octobre et 0.9.0 le 16 octobre entre-temps. Une release candidate 0.11.0 était déjà disponible en pré-release le 25 octobre. Partez du principe que vous devrez effectuer un rollback à un moment donné. Installez donc KiroCrew de manière à le permettre. Si vous n’avez jamais exécuté d’agent sur un serveur, exécuter un agent de programmation sur un VPS présente les règles de base sur lesquelles s’appuie ce guide. Si le fonctionnement des agents vous est moins familier que l’administration des serveurs, commencez par comprendre ce que sont réellement une boucle d’agent, ses outils et sa mémoire. Les choix présentés ensuite apparaîtront alors comme des décisions, et non comme des incantations.
Ce dont KiroCrew a besoin et où se trouve son état
Une installation native nécessite Python 3.12 ou une version ultérieure, ainsi que Node.js 22.12.0 ou une version ultérieure si vous compilez le dashboard depuis les sources (le projet recommande Node 24 LTS). Le backend Kiro CLI nécessite kiro-cli, authentifié avec kiro-cli login ou avec une clé d’API pour une utilisation automatisée. Depuis 0.10.0, le moteur KAS intégré fonctionne sans que kiro-cli soit installé, et 0.11.0 en a fait le moteur par défaut des nouvelles installations sans choix de harness enregistré. L’installation en conteneur ne nécessite aucun de ces composants sur l’hôte. Elle nécessite Docker. C’est la principale raison de la préférer.
L’état se trouve dans ~/.kiro/crew, et la variable d’environnement KIROCREW_HOME permet de le déplacer ailleurs. Son contenu est le suivant :
config.json: paramètres de la gateway et identifiants des canaux de chat..env: secrets.workspace/memory/: préférences, notes de projet et historique des conversations.memory.dbetmemory_index.db: index sémantique et full-text.models/: modèle d’embeddings, téléchargé lors de la première exécution.security_events.jsonl: journal des événements de sécurité.
Ce répertoire est l’installation. Copiez-le vers un nouveau VPS et vous aurez déplacé votre agent. C’est pourquoi la section consacrée aux sauvegardes ci-dessous est plus importante que celle consacrée à l’installation.
Prévoyez surtout de l’espace disque, plutôt que de la RAM. La gateway est un processus Python. Ce qui charge réellement la machine, ce sont les tâches exécutées par l’agent, un build ou une suite de tests. Le répertoire d’état grossit avec l’historique des conversations, et le modèle d’embeddings est téléchargé au premier démarrage. Mesurez donc sa taille sur votre propre machine avec du -sh ~/.kiro/crew après quelques semaines, au lieu de vous fier à un chiffre publié durant les premiers mois d’un projet. À l’inverse, dans un runtime qui fournit à chaque worker son propre conteneur et son propre navigateur, auto-héberger les collaborateurs IA d’OpenBot fait de la RAM un critère de dimensionnement avant le disque.
Quelle des quatre méthodes d’installation utiliser
Le projet en propose quatre : application desktop, wheel en une ligne, installation depuis les sources et Docker. L’installateur en une ligne télécharge une wheel et crée un lanceur kirocrew. Si son répertoire ne figure pas dans votre PATH, il affiche les instructions pour l’y ajouter :
curl -fsSL https://download.crew.kiro.dev/cli.sh | shIl accepte un flag de canal et un flag de version :
curl -fsSL https://download.crew.kiro.dev/cli.sh | sh -s -- --channel insider
curl -fsSL https://download.crew.kiro.dev/cli.sh | sh -s -- --version 0.8.0L’image de conteneur est publiée à l’emplacement ghcr.io/kirodotdev/kirocrew, pour linux/amd64 et linux/arm64 avec chaque tag. La compilation depuis les sources nécessite git clone et make build. Elle s’adresse aux personnes qui modifient le code, pas à celles qui exécutent l’application.
Utilisez le conteneur. Une installation native depuis les sources place les packages Python et Node sur le même hôte que vos autres services, ainsi que kiro-cli lorsque vous utilisez le backend Kiro CLI. Une mise à niveau qui échoue vous oblige alors à réparer cette installation manuellement. Le conteneur conserve le runtime dans une seule image et l’état dans un seul volume. Un rollback se résume ainsi à changer le tag et à redémarrer.
Épinglez l’image sur un tag de release, et non sur stable
L’exemple fourni par le projet utilise le tag stable :
docker run -d --name kirocrew \
-p 127.0.0.1:5476:5476 \
-v kirocrew-home:/home/kirocrew \
ghcr.io/kirodotdev/kirocrew:stablestable est un tag mobile, tout comme latest, qui pointe vers la même release. Il pointe vers la dernière release stable disponible. Le prochain pull peut donc modifier la version utilisée sans que vous l’ayez choisi. Le tag ne permet alors pas de savoir quelle version était utilisée. Les tags de version sont immuables : épinglez-en un. Au 1 novembre 2026, la dernière release stable est 0.11.1, publiée le 31 octobre 2026. Il s’agit d’un hot patch pour l’intégrité de la mémoire et les correctifs KAS dans 0.11.0. L’exemple 0.8.0 ci-dessous utilise Kiro CLI. Il existe également les tags insider et nightly. nightly suit les builds de main.
Écrivez /opt/kirocrew/compose.yaml :
services:
kirocrew:
image: ghcr.io/kirodotdev/kirocrew:0.8.0
container_name: kirocrew
restart: unless-stopped
ports:
- "127.0.0.1:5476:5476"
volumes:
- kirocrew-home:/home/kirocrew
volumes:
kirocrew-home:Démarrez-le, puis vérifiez l’endpoint de health check également utilisé par l’image pour son propre HEALTHCHECK :
cd /opt/kirocrew
docker compose up -d
docker compose ps
curl -s http://127.0.0.1:5476/api/healthdocker compose ps doit indiquer que le conteneur est healthy au bout d’environ une minute. /api/health répond sans token, tout comme /api/live et /api/ready, ce qui permet de les utiliser comme probes. Si l’état reste à starting, consultez docker logs kirocrew avant de modifier quoi que ce soit. Lors du premier démarrage, le téléchargement du modèle d’embedding s’effectue en arrière-plan. La recherche dans la mémoire utilise la correspondance par mots-clés jusqu’à la fin du téléchargement.
Le maintenir en fonctionnement avec systemd
restart: unless-stopped relance le conteneur après un crash et après un redémarrage, à condition que Docker démarre lui-même au boot. Un fichier d’unité rend cette dépendance explicite et fournit une commande unique pour arrêter toute la stack avant une sauvegarde. Démarrer une stack Docker Compose au boot présente le schéma général. Voici la structure utilisée pour KiroCrew, dans /etc/systemd/system/kirocrew.service :
[Unit]
Description=KiroCrew gateway
Requires=docker.service
After=docker.service
[Service]
Type=oneshot
RemainAfterExit=yes
WorkingDirectory=/opt/kirocrew
ExecStart=/usr/bin/docker compose up -d
ExecStop=/usr/bin/docker compose down
TimeoutStartSec=0
[Install]
WantedBy=multi-user.targetsudo systemctl daemon-reload
sudo systemctl enable --now kirocrew
systemctl status kirocrewsystemctl status kirocrew doit afficher active (exited), ce qui indique que cette unité fonctionne correctement. Utiliser Type=oneshot avec RemainAfterExit=yes est approprié ici, car docker compose up -d se termine dès que le conteneur est démarré : systemd suit le fait que la stack est active, et non un processus exécuté au premier plan. Si vous écrivez plutôt Type=simple, systemd voit la commande se terminer immédiatement, marque le service comme arrêté, puis abandonne ou entre dans une boucle de redémarrage selon le paramètre Restart=. Pour une installation native, le projet fournit son propre équivalent, kirocrew service install, qui écrit /etc/systemd/system/kirocrew.service et exécute la gateway avec votre compte utilisateur. N’exécutez pas les deux unités. La présentation plus générale de ce sujet se trouve dans Les services et timers systemd sur un VPS. Une unité qui ne redémarre pas reste silencieuse tant que vous ne lui ajoutez pas de mécanisme de notification. Ajoutez donc un gestionnaire OnFailure= qui envoie une alerte à votre propre serveur ntfy : vous saurez ainsi depuis votre téléphone que la gateway est arrêtée, au lieu de le découvrir via une tâche planifiée qui ne s’est jamais exécutée.
Premier lancement : connectez-vous et obtenez un token du dashboard
Le conteneur démarre la gateway, mais le runtime Kiro CLI par défaut de l’image 0.8.0 verrouillée doit encore être authentifié. Connectez-vous dans le conteneur ou transmettez KIRO_API_KEY via l’environnement du conteneur pour une utilisation automatisée :
docker exec -it kirocrew kiro-cli loginCette commande affiche un code d’appareil et une URL à ouvrir dans votre navigateur. Générez ensuite un token pour le dashboard :
docker exec kirocrew kirocrew token --ttl 2hL’URL du dashboard est http://localhost:5476/?token=<the token>. Les tokens expirent : le lien affiché doit être ouvert dans les cinq minutes suivant sa génération, et cette commande demande un cookie d’accès valable deux heures, la durée maximale documentée étant de vingt heures. Le navigateur reçoit également un cookie de renouvellement avec une fenêtre d’inactivité glissante de 30 jours. Une session active est donc renouvelée sans nécessiter un nouveau lien. Si le dashboard reste vide ou vous renvoie immédiatement à la page de connexion, le token a généralement expiré. Générez-en un nouveau et ouvrez-le immédiatement. Ne collez jamais un token dans un ticket ou un message de chat, car toute personne qui le détient contrôle votre agent.
Accéder au tableau de bord via SSH, sans jamais publier le port 5476
Regardez à nouveau l’adresse d’écoute dans l’exemple du projet : -p 127.0.0.1:5476:5476. Dans le conteneur, la gateway écoute sur 0.0.0.0, car elle doit être accessible via le mapping de port. Mais ce mapping publie uniquement le port sur loopback de l’hôte. Supprimez le préfixe 127.0.0.1: et la gateway devient accessible depuis Internet à toute personne qui analyse ce port. Une règle ufw ne vous protégera pas non plus : Docker publie les ports en écrivant des règles DNAT qui acheminent le trafic avant l’application des règles ufw. Par conséquent, ufw deny 5476 n’a aucun effet sur un port publié. Avec le backend iptables par défaut de Docker, Docker recommande de placer les règles de filtrage dans sa chaîne DOCKER-USER. Cette méthode fonctionne, mais ces règles voient l’adresse et le port internes du conteneur, sauf si vous utilisez l’extension conntrack pour effectuer la correspondance. Le bind sur loopback reste donc le contrôle le plus simple et le moins sujet aux erreurs. Le backend nftables de Docker utilise à la place des tables nftables et des chaînes de base distinctes pour le filtrage personnalisé. Les ports Docker qui contournent ufw décrit ce mécanisme.
Transférez plutôt le port via SSH depuis votre ordinateur portable :
ssh -N -L 5476:127.0.0.1:5476 you@your-server.example.comLaissez cette connexion active et ouvrez http://localhost:5476/?token=<the token> en local. Pour rendre le transfert automatique à chaque connexion, ajoutez-le dans ~/.ssh/config :
Host your-server.example.com
LocalForward 5476 127.0.0.1:5476Si le port 5476 est déjà utilisé sur votre ordinateur portable, modifiez uniquement le nombre à gauche : ssh -N -L 45476:127.0.0.1:5476 you@your-server.example.com, puis ouvrez http://localhost:45476/?token=.... Aucun réglage supplémentaire du port loopback ni recréation du conteneur n’est nécessaire : l’origine loopback correspond au Host de la requête, donc le contrôle CSRF l’accepte. Vous empilerez des transferts de ce type dès qu’un deuxième agent partagera la machine, car auto-héberger open-kritt pour l’analyse de sécurité ajoute un autre tableau de bord limité à loopback sur le même serveur, sur le port 5173.
Deux comportements documentés déterminent les réglages que vous pouvez modifier depuis le tableau de bord. Premièrement, la gateway considère comme distante toute requête qui contient des en-têtes de transfert (Forwarded, X-Forwarded-* ou X-Real-IP), et ses endpoints d’écriture de configuration et de révélation des secrets refusent ces requêtes. Un reverse proxy ajoute ces en-têtes ; un transfert ssh -L simple n’en ajoute aucun. La requête semble donc locale et n’est pas refusée pour cette raison. Deuxièmement, dans l’image du conteneur, les pages d’identifiants de canal et les vues qui révèlent des secrets sont en lecture seule pour tout navigateur qui n’est pas directement local, et l’image ne contient aucun éditeur de texte. Si un identifiant de canal ne peut pas être enregistré depuis le tableau de bord, c’est le comportement attendu, pas un bug. Modifiez plutôt la configuration sur l’hôte :
docker cp kirocrew:/home/kirocrew/.kiro/crew/config.json .
# edit config.json here
docker cp config.json kirocrew:/home/kirocrew/.kiro/crew/config.json
docker exec -u 0 kirocrew chown kirocrew:kirocrew /home/kirocrew/.kiro/crew/config.json
docker restart kirocrewPour l’accès depuis un téléphone, le projet recommande le tailscale serve de Tailscale. Il conserve le tableau de bord dans votre propre tailnet plutôt que sur un hostname public. Préférez cette solution à un reverse proxy public. Le token transite dans l’URL, et cette URL est inscrite dans chaque access log sur son chemin. Cette règle concerne ce qui se trouve derrière le port, et non le port lui-même : un service comme Halcyon, qui reconstruit une bibliothèque Jellyfin en vidéothèque des années 90 consultable est destiné à être ouvert par d’autres personnes et constitue un bon candidat pour un reverse proxy. En revanche, une gateway capable d’exécuter des commandes sur votre serveur ne l’est pas.
Donnez à l’agent le périmètre d’impact le plus réduit possible
Le conteneur vérifie la prise en charge du sandbox lors de son premier démarrage. Le résultat détermine si les agents peuvent exécuter des tâches. Si l’isolation par namespace est disponible, les sous-processus de l’agent s’exécutent de manière isolée. Si elle ne l’est pas et que KIROCREW_ALLOW_UNSANDBOXED=1 n’est pas défini, l’exécution est refusée plutôt que lancée sans isolation. C’est généralement la cause d’une gateway qui semble opérationnelle alors que toutes les tâches restent bloquées. La décision est enregistrée dans docker logs kirocrew lors de cette première exécution. Le projet publie également un profil seccomp (secure computing mode) que vous pouvez appliquer :
curl -fsSL https://raw.githubusercontent.com/kirodotdev/KiroCrew/main/docker/seccomp/kirocrew-seccomp.json \
-o /opt/kirocrew/kirocrew-seccomp.json security_opt:
- seccomp:./kirocrew-seccomp.jsonSur un hôte où AppArmor est activé, le guide Docker du projet considère que le profil seccomp ne constitue que la moitié de la modification. Docker attache également son profil AppArmor docker-default et associe ce profil à apparmor=unconfined. Cette option désactive uniquement les règles AppArmor propres au conteneur. Le profil seccomp, les capabilities supprimées et l’utilisateur non-root continuent de s’appliquer.
Si vous définissez KIROCREW_ALLOW_UNSANDBOXED=1, indiquez clairement ce qui change : le conteneur devient alors la seule frontière entre l’agent et votre serveur. L’avertissement du projet mérite d’être repris intégralement. Ne montez pas de chemins de l’hôte que vous ne remettriez pas directement à l’agent. En pratique, cela exclut le socket Docker, tout bind mount de / et tout répertoire contenant les données d’un autre service.
Le reste constitue le cadre applicable à chaque agent autorisé à exécuter des commandes. Limitez ses credentials au seul repository ou au seul bucket dont il a besoin. N’utilisez jamais un token personnel disposant de droits sur l’ensemble du compte. Exécutez-le avec un utilisateur dédié dont le home ne contient rien d’autre : c’est l’objectif de utilisateurs avec privilèges minimaux sur un VPS. Lorsque l’agent écrit du code puis l’exécute, donnez-lui une machine qu’il peut endommager : une VM jetable pour les agents de codage constitue une frontière plus solide que n’importe quel flag de ce fichier compose, car vous pouvez la supprimer au lieu de la nettoyer. Le même raisonnement s’applique à l’exécution sûre d’OpenClaw sur un VPS et à l’auto-hébergement de l’agent Hermes sur un VPS. Les outils contribuent eux aussi au périmètre d’impact : donner à l’agent accès à la recherche web transforme chaque page qu’il récupère en entrée non fiable. Ainsi, le rediriger vers votre propre instance SearXNG relève autant de la prévention des prompt injections que de la configuration technique. Les tâches planifiées peuvent également dépenser de l’argent pendant votre sommeil, car l’inférence sur les backends Kiro utilise votre forfait Kiro. Définissez donc les limites décrites dans contrôler le coût d’un agent IA sur un VPS avant d’ajouter une tâche nocturne.
Sauvegardez le volume d’état avant chaque mise à niveau
Trouvez d’abord le nom réel du volume. Compose préfixe les volumes nommés avec le nom du projet, qui correspond par défaut au nom du répertoire. Le volume déclaré comme kirocrew-home dans /opt/kirocrew/compose.yaml est donc créé sous le nom kirocrew_kirocrew-home :
docker volume lsArrêtez la passerelle avant toute copie. memory.db et memory_index.db sont des bases de données SQLite. Copier une base pendant une écriture peut capturer une transaction partiellement écrite, qui sera restaurée sous la forme d’un fichier corrompu. Les instructions de migration du projet indiquent la même chose : déplacez la mémoire uniquement lorsque les passerelles sont arrêtées. Cette règle d’arrêt préalable ne concerne pas uniquement KiroCrew. Si un serveur photo utilise le même hôte, la comparaison entre PhotoPrism et Immich fournit les commandes de sauvegarde exactes requises par chacun.
sudo systemctl stop kirocrew
docker run --rm -v kirocrew_kirocrew-home:/data:ro -v "$PWD":/backup \
alpine tar czf /backup/kirocrew-2026-08-06.tgz -C /data .
sudo systemctl start kirocrewCopiez l’archive sur une autre machine. La restauration utilise la même commande, avec le conteneur arrêté et tar xzf à la place de tar czf :
sudo systemctl stop kirocrew
docker run --rm -v kirocrew_kirocrew-home:/data -v "$PWD":/backup \
alpine tar xzf /backup/kirocrew-2026-08-06.tgz -C /data
sudo systemctl start kirocrewLe transfert vers un nouvel hôte est différent d’une restauration sur place, et le projet précise la procédure. L’historique des discussions et les notes de projet sous workspace/memory/ sont conservés, de même que les deux fichiers de base de données et config.json. Les fichiers PID, le journal des événements de sécurité et .env sont liés à l’ancien hôte. Ne les transférez pas et saisissez de nouveau les secrets sur le nouvel hôte.
Comment revenir en arrière après une mise à niveau défectueuse
La mise à niveau est rapide et elle est sûre uniquement parce que vous avez figé une version. Commencez par créer la sauvegarde, puis modifiez le tag :
sudo systemctl stop kirocrew
# take the backup here, as above
sudo nano /opt/kirocrew/compose.yaml # set the new image tag
sudo systemctl start kirocrew
docker compose -f /opt/kirocrew/compose.yaml ps
curl -s http://127.0.0.1:5476/api/healthdocker compose up -d récupère l’image si elle n’est pas déjà présente sur le serveur. La modification du tag constitue donc toute la mise à niveau. Pour revenir en arrière, utilisez la même procédure avec l’ancien numéro. Vous récupérez ainsi exactement l’image utilisée auparavant, car les tags de version sont immuables.
Le binaire revient correctement à la version précédente. L’état peut poser problème. Une passerelle plus récente peut réécrire config.json ou migrer les bases de données en mémoire vers un format qu’une passerelle plus ancienne ne sait pas lire. Au 12 octobre 2026, aucune procédure de rétrogradation de l’état n’est documentée. Le guide d’installation est explicite dans un cas : les données déplacées hors de l’emplacement historique ~/.kirocrew ne peuvent pas être restaurées par retour arrière, et une version antérieure à ~/.kiro/crew démarrerait sans données. Si l’ancienne image démarre puis se comporte de manière anormale, ne cherchez pas à diagnostiquer le problème. Arrêtez-la, restaurez la sauvegarde créée avant la mise à niveau, puis redémarrez. C’est précisément la raison pour laquelle la sauvegarde doit précéder la mise à niveau. C’est aussi pourquoi mettre à niveau maintenant et sauvegarder plus tard ne fonctionne pas sur un projet aussi récent.
Ce qui n’est pas démontré ici
Soyez conscient de l’ancienneté de ce logiciel. La version 0.1.3 est sortie le 5 August 2026 et, au 12 October 2026, la branche stable avait atteint 0.8.0. La plupart des notes de version sont encore des changelogs générés automatiquement ; les notes de 0.8.0 sont rédigées manuellement, mais ne contiennent aucune section sur la migration, et l’historique public des versions couvre environ trois mois. Rien dans ce guide ne constitue un résultat établi sur le long terme. Considérez donc l’augmentation de l’utilisation mémoire, la taille de la base de données et la fiabilité du scheduler comme des éléments à mesurer sur votre propre machine, et non comme des caractéristiques acquises.
Deux comportements méritent d’être testés vous-même avant de leur faire confiance. D’abord, vérifiez si un downgrade peut lire l’état écrit par une version plus récente : faites l’essai sur une copie du volume, tant que cela n’a pas de conséquence, et non pendant une panne. Ensuite, vérifiez ce que fait la gateway lorsque la session Kiro expire alors qu’un job planifié doit s’exécuter. Ce sont deux limites typiques qu’un projet récent corrige discrètement entre deux versions, et qu’il est facile de vérifier dès maintenant.
FAQ
Pourquoi le tableau de bord KiroCrew ne s’ouvre-t-il pas sur l’adresse IP publique de mon serveur ?
Parce que l’exemple publié lie le port à loopback. -p 127.0.0.1:5476:5476 mappe le port du conteneur uniquement sur l’adresse loopback de l’hôte, et ce comportement est volontaire. Accédez-y en transférant le port via SSH avec ssh -N -L 5476:127.0.0.1:5476 you@your-server, puis ouvrez http://localhost:5476/?token=<token> sur votre ordinateur portable. Supprimer le préfixe 127.0.0.1: pour rendre le service accessible place la gateway sur Internet public. ufw ne la protégera pas, car les règles DNAT des ports publiés par Docker acheminent le trafic avant l’application des règles ufw. Utilisez la chaîne DOCKER-USER de Docker avec son backend iptables, ou des chaînes de base nftables distinctes avec son backend nftables, pour filtrer les ports publiés. Conserver la liaison loopback est plus simple.
Où KiroCrew stocke-t-il ses données et que dois-je sauvegarder ?
Tout se trouve sous ~/.kiro/crew, qui correspond à /home/kirocrew/.kiro/crew dans l’image du conteneur, et KIROCREW_HOME permet de le déplacer. Sauvegardez l’ensemble du répertoire, ou l’intégralité du volume Docker, avec la gateway arrêtée. memory.db et memory_index.db sont des bases de données SQLite. Une copie effectuée pendant que la gateway écrit peut donc être incohérente. Lors d’une migration vers un nouvel hôte, workspace/memory/, les deux fichiers de base de données et config.json sont transférés. En revanche, les fichiers PID, le journal des événements de sécurité et .env appartiennent à l’ancien hôte.
Dois-je utiliser le tag stable ou un tag de version ?
Utilisez un tag de version. stable change à chaque nouvelle release. La version exécutée peut donc changer lors du prochain pull, et le tag lui-même ne permet pas de savoir ce qui s’exécute. Les tags de version tels que 0.8.0 sont immuables. C’est précisément ce qui permet d’effectuer un rollback : vous rétablissez l’ancien numéro et récupérez une image identique. Au 1 novembre 2026, la dernière release stable est 0.11.1.
Pourquoi mon agent refuse-t-il d’exécuter des commandes ?
Le conteneur vérifie la prise en charge du sandbox lors de son premier démarrage. S’il ne peut pas isoler les sous-processus de l’agent et que KIROCREW_ALLOW_UNSANDBOXED=1 n’est pas défini, il refuse de les exécuter plutôt que de les lancer sans isolation. La gateway semble alors fonctionnelle, mais chaque tâche reste bloquée. docker logs kirocrew affiche la décision concernant le sandbox prise lors de cette première exécution. Définir cette variable fait du conteneur l’unique barrière entre l’agent et l’hôte. Si vous la définissez, ne montez donc aucun élément que vous ne remettriez pas directement à l’agent.
Ai-je besoin d’un compte Kiro pour auto-héberger KiroCrew ?
Pour les backends Kiro, oui, au 1 novembre 2026. KiroCrew est un logiciel libre sous licence Apache 2.0, mais l’inférence sur ces backends utilise votre plan Kiro. Le conteneur 0.8.0 épinglé utilise Kiro CLI : exécutez docker exec -it kirocrew kiro-cli login et approuvez le code d’appareil dans votre navigateur, ou transmettez KIRO_API_KEY via l’environnement du conteneur pour une utilisation automatisée. Tant que l’authentification n’est pas configurée, la gateway démarre et le tableau de bord se charge, mais son harness par défaut n’a aucun modèle avec lequel communiquer. Depuis 0.10.0, un moteur KAS intégré est également disponible et ne nécessite pas l’installation de kiro-cli. 0.11.0 a fait de KAS le moteur par défaut pour les nouvelles installations sans choix de harness enregistré, tout en conservant les sélections explicites de Kiro CLI. KAS utilise le mécanisme de connexion de Crew au lieu de kiro-cli login. Le guide du projet consacré aux backends personnalisés permet à un harness claude d’envoyer les requêtes principales du modèle vers un endpoint compatible Anthropic de votre choix, mais la connexion kiro-cli reste nécessaire pour les fonctionnalités propres à Kiro.