Installer la gate

La gate tourne sur un serveur Linux avec KVM. Une commande l’installe, une seconde la connecte à votre organisation.

Prérequis

• Linux x86_64 avec KVM : un serveur physique, ou une VM avec virtualisation imbriquée.
• Ubuntu 24.04 ou plus récent, ou Debian 13 ou plus récent.
• Environ 3,5 Go libres pendant l’installation, 1,5 Go ensuite.
• HTTPS sortant vers votre serveur Noset, GitHub et le registre npm.

Note

macOS 13 ou plus récent (Apple silicon et Intel) est en test : la même commande y fonctionne et installe la gate pour votre propre utilisateur.

Installer et connecter

1. Installez la gate. Lancez la commande avec sudo depuis l’utilisateur sous lequel la gate doit tourner :

   curl -fsSL https://get.noset.ai/install.sh | sudo bash

2. Connectez-la à votre organisation :

   Noset Cloud

   noset login

   Sur site

   noset login --server https://noset.example.com

   Derrière un proxy qui ouvre TLS, ajoutez --ca-cert ca.pem.

3. Ouvrez le lien affiché sur votre ordinateur ou téléphone. Vérifiez que le code correspond au terminal, nommez la gate puis cliquez sur Connect server.

L’application web affiche les mêmes deux commandes, avec l’adresse de votre serveur, sous Gates › Connect a server.

Ce que fait le script

Le script est court et lisible : get.noset.ai/install.sh. Il

• vérifie la machine (root, x86_64, KVM, systemd, distribution, espace disque) ;
• installe virtiofsd, uidmap et zstd depuis votre distribution ;
• télécharge noset et le système de fichiers racine du bac à sable chez Noset, Cloud Hypervisor et le noyau invité sur GitHub, Claude Code sur npm, et vérifie le SHA-256 de chaque fichier avant de l’utiliser ;
• construit sur votre serveur le disque d’outils avec Claude Code ;
• ajoute votre utilisateur au groupe kvm et démarre noset.service, qui attend noset login.

Relancez-le pour mettre à jour. Les clés, la connexion et les preuves de la gate sont conservées.

Connecter plusieurs serveurs d’un coup

Pour la CI ou un parc, créez un jeton dans l’application web (Gates › Connect a server › With a token) et lancez sur chaque serveur :

curl -fsSL https://get.noset.ai/install.sh | sudo bash
noset login --server https://noset.example.com --token nst_en_…

Un jeton vaut pour la durée et le nombre de serveurs choisis, et chaque serveur reçoit sa propre clé.

Lancer un premier agent

cd ~/projet
noset run --credential ANTHROPIC_API_KEY -- claude

L’agent tourne dans le bac à sable, votre dossier de projet est sous /workspace. Sa clé d’API reste dans la gate ; l’agent ne voit qu’un substitut.