Installer Konsolity CLI

Mis à jour le 10 novembre 2026

Konsolity CLI est la commande konsolity, à installer sur un serveur ou un poste sans interface graphique. Une fois activée depuis votre compte, elle donne accès aux hôtes, aux snippets et aux sessions de votre coffre dans la limite de la portée que vous lui avez donnée, et sert de serveur MCP local aux agents Claude (Claude Code par exemple). Elle fonctionne comme Claude Code en ligne de commande : on l'installe, on l'active une fois par un code, puis on s'en sert.

Offre requise

Konsolity CLI est réservée à l'offre Studio et à son essai gratuit. Le serveur vérifie l'offre à chaque appel de la machine : sans elle, chaque commande répond « Abonnement requis ». La liste des machines et la révocation restent toujours accessibles, même sans l'offre.

Choisir la machine

N'importe quel ordinateur qui peut joindre vos hôtes en SSH : un serveur d'administration, une petite machine virtuelle, un Mac mini, un poste de développement, un exécuteur de CI. La machine n'a besoin d'aucun port entrant, seulement d'un accès sortant en HTTPS vers api.konsolity.com.

Système Architectures Formats
Linux (Debian, Ubuntu, Fedora, RHEL et dérivés, toute distribution par l'archive) x64, arm64 script, .deb, .rpm, .tar.gz
macOS (Intel et Apple silicon) une archive par architecture (x64, arm64), binaire signé Developer ID et notarisé · macOS 11 ou plus script, Homebrew, .tar.gz
Windows x64 script PowerShell, .zip

Linux et macOS : script d'installation

La méthode la plus simple. Le script détecte le système et l'architecture, télécharge le bon fichier, vérifie son empreinte SHA-256 et la signature Ed25519 de l'éditeur, puis l'installe :

curl -fsSL https://konsolity.com/cli/install.sh | sh

Pour lire le script avant de l'exécuter :

curl -fsSLO https://konsolity.com/cli/install.sh
less install.sh
sh install.sh

Le script s'arrête sans rien installer si l'empreinte ou la signature ne correspondent pas.

Linux : paquet .deb (Debian, Ubuntu)

Téléchargez le paquet de votre architecture, puis :

sudo apt install ./konsolity_<version>_amd64.deb

Sur arm64 (Raspberry Pi 4 ou 5, serveurs Graviton ou Ampere), prenez konsolity_<version>_arm64.deb. Les mises à jour passent ensuite par apt.

Linux : paquet .rpm (Fedora, RHEL, Rocky, Alma)

sudo dnf install ./konsolity-<version>.x86_64.rpm

Sur arm64, le fichier se termine par .aarch64.rpm. Les mises à jour passent ensuite par dnf.

Linux : archive .tar.gz

Pour toute autre distribution, l'archive contient le binaire seul :

tar -xzf konsolity_<version>_linux_amd64.tar.gz
sudo install -m 0755 konsolity /usr/local/bin/konsolity

Remplacez amd64 par arm64 sur une machine ARM.

macOS : Homebrew

brew install konsolity/tap/konsolity

Les mises à jour passent ensuite par brew upgrade konsolity. Le script d'installation et l'archive konsolity-<version>-macos-x64.tar.gz (Intel) / konsolity-<version>-macos-arm64.tar.gz (Apple silicon) fonctionnent aussi.

Windows : PowerShell

Dans PowerShell (sans droits administrateur) :

irm https://konsolity.com/cli/install.ps1 | iex

Le script fait les mêmes vérifications que sur Linux, installe konsolity.exe dans votre profil et l'ajoute au PATH de l'utilisateur. Ouvrez un nouveau terminal pour en profiter.

Windows : archive .zip

L'archive konsolity_<version>_windows_amd64.zip contient konsolity.exe. Décompressez-la dans un dossier de votre choix, puis ajoutez ce dossier à votre PATH.

Vérifier un téléchargement

Chaque version est décrite par le manifeste signé https://konsolity.com/cli/latest.json : version, liste des fichiers (système, architecture, format, adresse, empreinte SHA-256) et signature Ed25519 de l'éditeur. Les scripts et konsolity update refusent un fichier dont l'empreinte ou la signature ne correspondent pas. Pour vérifier vous-même un paquet téléchargé à la main :

curl -fsSL https://konsolity.com/cli/latest.json
sha256sum konsolity_<version>_amd64.deb

Sur macOS, utilisez shasum -a 256 ; sur Windows, Get-FileHash konsolity_<version>_windows_amd64.zip. L'empreinte affichée doit être exactement celle du manifeste.

Vérifier l'installation

konsolity version

La commande affiche la version, le système et l'architecture.

Mettre à jour

konsolity update

konsolity update lit le manifeste, vérifie l'empreinte et la signature de la nouvelle version, puis remplace le binaire. Si konsolity a été installée par apt, dnf ou Homebrew, la commande vous renvoie vers ce gestionnaire de paquets plutôt que de remplacer le fichier elle-même.

Si le service systemd est installé, lancez sudo konsolity update : la commande met à jour /usr/local/bin/konsolity, puis redémarre le service. Le minuteur konsolity-update.timer le fait aussi tout seul deux fois par jour.

Ensuite

  1. Activer la machine avec un code validé depuis votre compte.
  2. Choisir sa portée : hôtes, snippets, règles de commande.
  3. Découvrir les commandes, brancher Claude Code, ou la faire tourner en service.