LangueFrançais

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é.

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). 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.