Installation
Application web pour iPhone, iPad et Android
L’application web AirCode Ø reste disponible sans boutique d’applications. Elle est servie par votre propre instance en cours d’exécution et ne fait pas partie du canal des téléchargements signés. Elle reste donc accessible indépendamment de Google Play, de l’App Store et de TestFlight.
- Démarrez une instance AirCode Ø et donnez-lui une adresse HTTPS stable. Consultez Démarrage rapide et Accès distant.
- Ouvrez la page d’installation de l’application web, saisissez l’origine HTTPS de votre instance, puis choisissez Ouvrir la page d’installation. Cette option se trouve aussi sur la page Télécharger. Le site vérifie l’adresse localement : il ne la reçoit et ne l’enregistre jamais.
- Connectez-vous sur l’instance. Chromium propose sa propre installation ; sur iPhone et iPad, suivez le guide Partager → Ajouter à l’écran d’accueil.
- Ouvrez l’icône installée. Activez les notifications Push uniquement si vous souhaitez recevoir des alertes quand l’application est fermée. Sur iOS et iPadOS, ce réglage n’est proposé que dans l’application web ouverte depuis l’écran d’accueil.
L’installation est liée à une origine précise. Une adresse HTTP sur le réseau local ne suffit pas pour installer complètement une PWA mobile. Si l’adresse HTTPS de l’instance change, il faut faire une nouvelle installation et parfois se reconnecter. L’application web se met à jour depuis votre instance grâce à son service worker ; ce n’est ni un APK, ni un IPA, ni un paquet distribué par une boutique.
L’application web donne accès au cœur de l’espace de travail sur les petits écrans. L’application mobile native reste préférable si vous avez besoin de basculer entre serveurs dans l’application, de fichiers hors connexion chiffrés, de tâches de fond limitées mais plus fiables, du partage et de la numérisation natifs, de retours haptiques, de la priorité des canaux de notification ou de liens profonds gérés par le système.
Serveur Linux
L’installateur n’est publié qu’après la validation du manifeste de la version, des sommes de contrôle et des signatures. Avant de lancer la commande, vérifiez que la version serveur est indiquée comme disponible sur la page des téléchargements.
curl -fsSL https://dl.aircodezero.com/install.sh | bash
Cette commande installe la dernière version stable. Les options de
l’installateur, plus bas, permettent de choisir une version bêta ou une version
précise.
L’installateur :
- détecte votre plateforme (
linux-x64oulinux-arm64) ; - télécharge l’archive de la version et vérifie sa somme de contrôle SHA-256 et sa signature Ed25519 ;
- installe les fichiers dans
~/.aircode/versions/<version>avec un lien symbolique~/.aircode/current; - crée le lien vers
aircodedans~/.local/bin; - vérifie les dépendances système (
git,tmux) et indique précisément celles qui manquent.
Les droits administrateur ne sont pas nécessaires. Tous les fichiers se trouvent
dans votre dossier personnel. Relancer l’installateur répare ou met à jour
l’installation. Si ~/.local/bin ne figure pas dans le PATH du shell actuel,
les instructions finales utilisent le chemin immédiatement exécutable
~/.aircode/current/bin/aircode et montrent aussi comment ajouter le dossier
au PATH si vous le souhaitez.
Démarrez ensuite l’instance depuis le dossier qui contiendra les projets à sélectionner :
cd /srv/workspaces
aircode start
Sur Linux, aircode start crée une configuration liée à ce dossier, choisit un
port libre, génère et affiche un mot de passe, démarre un service systemd pour
l’utilisateur et active le redémarrage après une panne ou un redémarrage de la
machine. La commande essaie aussi d’activer systemd linger et affiche une
commande de correction précise si l’hôte exige des droits administrateur. Vous
n’avez pas à écrire de fichier de service.
Si cette installation possède encore l’ancien service aircode.service, le
premier aircode start le retire sans danger avant de créer le nouveau service
lié au dossier, afin d’éviter que deux serveurs utilisent le même port. Les
services appartenant à une autre installation ne sont pas modifiés.
Options de l’installateur : --channel beta (le canal par défaut est
stable), --version x.y.z et --no-modify-path. L’ancienne
option --service reste compatible avec le service à instance unique ; pour
une nouvelle installation, utilisez aircode start.
Configuration requise
| Élément | Précisions |
|---|---|
| Linux x64 / arm64 | Ubuntu 22.04 ou version ultérieure, Debian 12 ou version ultérieure, Fedora récent ; glibc |
git, tmux |
sudo apt-get install -y git tmux |
| CLI des agents | Installées et connectées avec vos comptes ; utilisez les versions testées dans le guide de démarrage pour les intégrations TUI sensibles à la version |
| systemd | Nécessaire pour la persistance de aircode start, mais pas pour aircode serve au premier plan |
L’environnement Node.js est intégré : aucune installation système de Node n’est requise.
Docker
L’image publique aircodezero/aircode exécute le même paquet serveur Linux
publié que celui qu’installe install.sh. Node.js, le client web, Claude Code,
Codex, Grok Build et Kimi Code sont inclus. Elle est publiée pour linux/amd64
et linux/arm64, avec les tags stable et beta ainsi que des tags de version
exacte comme 0.1.30.
Démarrez-la sur n’importe quel hôte Docker avec une seule commande :
docker run -d --name aircode --restart unless-stopped --stop-timeout 30 -p 7860:7860 -v aircode-home:/home/aircode aircodezero/aircode:stable
Docker Compose
Le site fournit un fichier compose.yaml prêt à l’emploi. Enregistrez-le dans un dossier dédié et démarrez-le depuis ce dossier :
curl -fsSLO https://aircodezero.com/docker/compose.yaml
docker compose up -d
Déployer sur Hostinger
Déployer sur Hostinger Le parcours guidé prépare l’accès de votre navigateur avant d’ouvrir Hostinger.
- Choisissez un VPS Ubuntu 24.04 avec Docker (x86-64). KVM 2 (2 vCPU, 8 Go de RAM) convient à un petit test. Vérifiez le prix et le renouvellement avant de payer.
- Docker Manager ouvre la recette préparée. Sélectionnez Deploy, puis utilisez le lien Open HTTPS du projet.
- Continuez dans le navigateur qui a lancé le déploiement, confirmez l’adresse de l’instance et choisissez son mot de passe. Conservez les données du site dans ce navigateur jusqu’à la fin de la configuration.
Premier accès
Ces étapes concernent Docker en installation manuelle (docker run ou le Compose portable). Pour Hostinger, utilisez le parcours HTTPS ci-dessus.
Ouvrez http://<server-address>:7860. Au premier démarrage, le conteneur
affiche une seule fois un mot de passe généré dans ses journaux :
docker logs aircode
Pour choisir vous-même le mot de passe, définissez la variable d’environnement
AIRCODE_AUTH_PASSWORD lors de la création du conteneur. Vous pourrez modifier
le mot de passe plus tard dans les paramètres de l’application.
Adresse HTTPS privée
Dans AirCode Ø, ouvrez Paramètres → Accès distant et choisissez Se connecter pour associer votre compte AirCode Ø. Le serveur obtient alors son adresse HTTPS privée via le Relay :
https://<name>.tunnel.aircodezero.com
La connexion au Relay est uniquement sortante : aucun port n’est à ouvrir. Consultez Accès distant pour plus de détails.
Données et mises à jour
Les projets, les connexions aux fournisseurs, les conversations et les
paramètres se trouvent tous dans le volume aircode-home. Supprimer le volume
les supprime.
Pour mettre à jour, téléchargez la nouvelle image et recréez le conteneur. Avec
Docker Compose, exécutez cette commande à côté de compose.yaml :
docker compose pull && docker compose up -d
Avec docker run, téléchargez l’image, arrêtez et supprimez le conteneur, puis
relancez la même commande docker run :
docker pull aircodezero/aircode:stable
docker stop aircode && docker rm aircode
Le conteneur ne démarre jamais une version plus ancienne qu’une version que son volume a déjà exécutée. Si le processus serveur s’arrête dans le conteneur, celui-ci le redémarre, et les sessions des agents survivent à ce redémarrage.
macOS
Application de bureau (recommandée) : téléchargez le .dmg depuis la
page des téléchargements. L’application contient le serveur
complet pour les sessions locales et se connecte aussi aux serveurs distants.
Sans interface graphique / CLI : la même commande d’installation que sur
Linux fonctionne à partir de macOS 13 (darwin-arm64 ou darwin-x64). Installez
d’abord tmux avec Homebrew, puis utilisez aircode serve ; le démarrage
persistant avec aircode start exige actuellement systemd sur Linux.
Windows
Installez l’application de bureau depuis la
page des téléchargements. Les sessions locales s’exécutent
nativement sur Windows avec ConPTY. L’installateur contient le serveur et son
environnement Node.js : ni WSL, ni distribution Linux, ni installation de Node
sur le système ne sont nécessaires. Il ajoute aussi aircode au PATH de
l’utilisateur, ce qui permet de lancer le serveur intégré depuis PowerShell ou
Command Prompt. Ouvrez un nouveau terminal après l’installation et consultez
le guide de la ligne de commande Windows.
L’application peut également se connecter à des serveurs AirCode Ø distants.
Modes de fonctionnement sur ordinateur
| Objectif | Démarrage | Résultat |
|---|---|---|
| Client distant seulement | Ouvrez AirCode Ø et choisissez Se connecter à un serveur, sans configurer Local | La fenêtre Electron affiche le serveur AirCode Ø distant choisi |
| Client et serveur locaux | Ouvrez AirCode Ø, choisissez un dossier de projets, puis Exécuter sur cette machine | Electron démarre et gère le serveur natif intégré, puis ouvre son espace de travail |
| Serveur seulement | Exécutez aircode serve --projects-root "D:\Projects" dans PowerShell ou Command Prompt |
Le serveur intégré reste au premier plan, sans fenêtre Electron |
Ne démarrez pas l’application de bureau avec --serve : cela ouvre Electron et
ne crée pas de mode serveur seul. Pour un serveur sans fenêtre, utilisez la
commande aircode installée dans le PATH.
Une fois le mode Local configuré, le démarrage normal de l’application de bureau
veille à ce que le serveur intégré fonctionne, même si la fenêtre est connectée
à un serveur distant. Ce serveur n’écoute que sur 127.0.0.1. Pour vous
connecter depuis un autre appareil, utilisez
l’accès distant ou démarrez un serveur CLI qui écoute
explicitement sur une adresse du réseau privé.
Sur Windows, fermer toutes les fenêtres laisse AirCode Ø et son serveur intégré actifs dans la zone de notification. Choisissez Quitter depuis cette icône pour arrêter le serveur. Un serveur CLI est un processus distinct qui peut coexister sur un autre port. Voir la section coexistence avec l’application de bureau.
Composants facultatifs volumineux
Rien de volumineux n’est téléchargé sans action explicite :
aircode browser install # pinned Chromium for the agent browser
aircode doctor browser # verify it
Knowledge utilise une recherche lexicale tant que vous n’avez pas installé explicitement un modèle local d’embeddings dans ses paramètres. Ce modèle est alors vérifié et utilisé hors connexion ; l’indexation ne déclenche jamais de téléchargement implicite.