Install Konsolity CLI
Konsolity CLI is the konsolity command, to install on a server or on a machine without a graphical interface. Once activated from your account, it gives access to the hosts, snippets and sessions of your vault within the scope you gave it, and serves as a local MCP server for Claude agents (Claude Code for example). It works like Claude Code on the command line: install it, activate it once with a code, then use it.
Required plan
Konsolity CLI is reserved for the Studio plan and its free trial. The server checks the plan on every call of the machine: without it, every command answers "Subscription required". The machine list and revocation always stay available, even without the plan.
Choose the machine
Any computer that can reach your hosts over SSH: an administration server, a small virtual machine, a Mac mini, a development workstation, a CI runner. The machine needs no inbound port, only outbound HTTPS access to api.konsolity.com.
| System | Architectures | Formats |
|---|---|---|
| Linux (Debian, Ubuntu, Fedora, RHEL and derivatives, any distribution through the archive) | x64, arm64 | script, .deb, .rpm, .tar.gz |
| macOS (Intel and Apple silicon) | one archive per architecture (x64, arm64), Developer ID signed and notarized binary · macOS 11 or later | script, Homebrew, .tar.gz |
| Windows | x64 | PowerShell script, .zip |
Linux and macOS: install script
The simplest way. The script detects the system and the architecture, downloads the right file, checks its SHA-256 hash and the publisher's Ed25519 signature, then installs it:
curl -fsSL https://konsolity.com/cli/install.sh | sh
To read the script before running it:
curl -fsSLO https://konsolity.com/cli/install.sh
less install.sh
sh install.sh
The script stops without installing anything if the hash or the signature do not match.
Linux: .deb package (Debian, Ubuntu)
Download the package for your architecture, then:
sudo apt install ./konsolity_<version>_amd64.deb
On arm64 (Raspberry Pi 4 or 5, Graviton or Ampere servers), take konsolity_<version>_arm64.deb. Updates then go through apt.
Linux: .rpm package (Fedora, RHEL, Rocky, Alma)
sudo dnf install ./konsolity-<version>.x86_64.rpm
On arm64, the file ends with .aarch64.rpm. Updates then go through dnf.
Linux: .tar.gz archive
For any other distribution, the archive contains the binary alone:
tar -xzf konsolity_<version>_linux_amd64.tar.gz
sudo install -m 0755 konsolity /usr/local/bin/konsolity
Replace amd64 with arm64 on an ARM machine.
macOS: Homebrew
brew install konsolity/tap/konsolity
Updates then go through brew upgrade konsolity. The install script and the konsolity-<version>-macos-x64.tar.gz (Intel) / konsolity-<version>-macos-arm64.tar.gz (Apple silicon) archive work too.
Windows: PowerShell
In PowerShell (no administrator rights needed):
irm https://konsolity.com/cli/install.ps1 | iex
The script makes the same checks as on Linux, installs konsolity.exe in your profile and adds it to the user PATH. Open a new terminal to use it.
Windows: .zip archive
The konsolity_<version>_windows_amd64.zip archive contains konsolity.exe. Extract it into a folder of your choice, then add that folder to your PATH.
Check a download
Each version is described by the signed manifest https://konsolity.com/cli/latest.json: version, list of files (system, architecture, format, address, SHA-256 hash) and the publisher's Ed25519 signature. The scripts and konsolity update refuse a file whose hash or signature does not match. To check a package you downloaded by hand yourself:
curl -fsSL https://konsolity.com/cli/latest.json
sha256sum konsolity_<version>_amd64.deb
On macOS, use shasum -a 256; on Windows, Get-FileHash konsolity_<version>_windows_amd64.zip. The hash shown must be exactly the one in the manifest.
Check the installation
konsolity version
The command shows the version, the system and the architecture.
Update
konsolity update
konsolity update reads the manifest, checks the hash and the signature of the new version, then replaces the binary. If konsolity was installed with apt, dnf or Homebrew, the command points you to that package manager instead of replacing the file itself.
If the systemd service is installed, run sudo konsolity update: it updates /usr/local/bin/konsolity, then restarts the service. The konsolity-update.timer timer also does it on its own twice a day.
Next
- Activate the machine with a code approved from your account.
- Choose its scope: hosts, snippets, command rules.
- Discover the commands, connect Claude Code, or run it as a service.