Dépannage

Premières vérifications

aircode ps -a               # every path-scoped instance and its boot state
aircode inspect [instance]  # root, port, auth, Relay, service and state paths
aircode logs [instance] --follow
aircode doctor packaging    # install integrity: checksums, runtime, symlink
aircode doctor browser      # agent browser stack
aircode doctor tokens       # token-optimization stack

Problèmes courants

J’ai perdu le mot de passe. Exécutez aircode password reset [instance]. Une instance Linux persistante redémarre automatiquement avec le nouveau mot de passe.

L’URL ne s’ouvre pas sur mon téléphone. Par défaut, le serveur écoute sur Tailscale s’il est disponible, sinon uniquement sur l’adresse locale. Consultez aircode status pour connaître l’adresse utilisée et vérifiez que le téléphone est sur le même tailnet ou VPN. Voir Accès distant.

Le port est déjà utilisé. AirCode Ø cherche automatiquement un port libre à partir de 7860, sauf si vous avez indiqué un port précis. Dans ce cas, un port occupé provoque volontairement une erreur : libérez-le ou retirez ce réglage.

L’instance redémarre après une panne, mais seulement après ma connexion à la machine. aircode inspect affiche Boot: after-login si le service est activé mais que systemd linger n’est pas disponible. Exécutez la commande affichée par aircode start, généralement sudo loginctl enable-linger $USER, puis vérifiez que loginctl show-user $USER --property=Linger renvoie Linger=yes.

Le service redémarre en boucle. Consultez d’abord aircode logs <instance>. Le port fixé dans la configuration peut être occupé, le dossier des projets peut avoir disparu ou une dépendance système peut manquer. Corrigez la cause indiquée, puis exécutez aircode restart <instance>.

Le dossier racine désigne plusieurs instances. Plusieurs instances nommées utilisent le même chemin. Exécutez aircode ps -a, puis indiquez le nom unique ou l’identifiant court de l’instance voulue.

Le Relay géré demande une connexion. Autorisez une fois l’utilisateur Unix avec aircode login, vérifiez avec aircode whoami, puis relancez aircode start <instance> --relay managed. Le Relay géré exige aussi un mot de passe d’instance non vide.

tmux ou git manque. Installez-les avec sudo apt-get install -y git tmux, puis réessayez. L’installateur et les commandes de diagnostic indiquent exactement les éléments manquants.

Un moteur n’est pas détecté. Les CLI doivent être installées et connectées pour l’utilisateur qui exécute AirCode Ø. Ouvrez d’abord un shell sous ce compte et essayez claude, codex ou la commande du moteur concerné.

L’environnement Docker isolé est indisponible. Le formulaire de lancement affiche la raison exacte. Démarrez Docker, puis exécutez npm run docker:runtime:build pour l’aperçu actuel depuis le code source, ou téléchargez l’image publique configurée lorsqu’elle sera disponible. Vérifiez avec npm run docker:runtime:check.

DOCKER_ENGINE_UNAVAILABLE. L’image est valide, mais ce moteur n’est pas activé dans sa liste de moteurs pour les sessions ordinaires. L’image standard active Claude Code, Codex, Grok Build et Kimi Code. Recréez ou téléchargez l’image actuelle, choisissez un moteur activé ou passez la session en mode Local.

DOCKER_CONTROL_UNAVAILABLE. Le canal de rappel du conteneur n’a pas pu utiliser son port fixe. Libérez AIRCODE_DOCKER_CONTROL_PORT ou configurez un autre port fixe, puis redémarrez AirCode Ø avant de lancer un nouvel agent.

Mon VPN ne transporte pas le trafic des agents. Les conteneurs Docker utilisent un réseau bridge/NAT, parfois exclu des VPN à tunnel partagé. Ajoutez le sous-réseau Docker aux règles du VPN ou du pare-feu. Le tunnel géré d’AirCode Ø sert aux connexions entrantes ; il ne fournit pas de VPN sortant aux conteneurs.

Un serveur de développement lancé dans Docker est inaccessible. Les ports des conteneurs ne sont pas publiés dans l’aperçu actuel. Un transfert authentifié via AirCode Ø et la route Hetzner est prévu dans une prochaine étape réseau.

La mise à jour indique que ma version est trop ancienne. Les installations très anciennes doivent être réinstallées avec la commande d’installation unique au lieu d’être mises à jour sur place. Le message d’erreur l’indique.

L’installation semble corrompue. aircode doctor packaging repère les fichiers modifiés. Relancez l’installateur pour réparer l’installation (curl -fsSL …/install.sh | bash -s -- --channel beta). La configuration, les sessions et les données restent intactes : elles sont stockées en dehors du dossier de la version.

Une ancienne installation mentionne un mode restreint ou une licence. Les versions actuelles d’AirCode Ø donnent accès au produit complet à auto-héberger, gratuitement. L’absence ou l’expiration d’une clé produit ou d’un essai ne bloque plus le lancement de sessions. Mettez à jour ou réinstallez depuis le canal signé actuel ; aircode license status subsiste seulement pour consulter un ancien état.

Toujours bloqué ?

Récupérez les sorties de aircode ps -a --json, aircode inspect <instance> --json et aircode doctor packaging --json, ainsi que les 100 dernières lignes du journal. Utilisez ensuite le canal d’assistance indiqué dans votre invitation à la bêta. Examinez les sorties avant de les partager : les journaux de diagnostic sont conçus pour exclure le code et les prompts.