Get started

Quickstart

Install the CLI, sign in, create a Kiste, open its desktop and stop it again.

This takes about five minutes. You need a Kiste account and a computer with macOS, Linux or Windows.

Early access

Kiste is in early access. Accounts are created by invitation; request one at kiste.run. Using Kiste is free during early access.

Install the CLI

On macOS and Linux:

curl -fsSL https://kiste.run/install.sh | sh

The installer checks the release signature and the checksum before it installs kiste (and kst, the short name) into ~/.local/bin. Windows and other options are in Install the CLI.

Sign in

kiste login

Your browser opens the Kiste console at console.kiste.run. Sign in if you aren't already and approve the computer. Back in the terminal, the CLI is signed in, and this computer's SSH key has been added to your account, so every Kiste accepts it.

Create your first Kiste

kiste new my-first-kiste

The Kiste starts in seconds and you land in its shell as root. Try a few things:

uname -a
docker run --rm hello-world
exit

exit leaves the shell; the Kiste keeps running. Because you created it last, it is now your current Kiste, so the following commands need no name.

Run a command from outside

kiste exec -- git --version

exec runs a program in the Kiste and returns its exact output and exit status, which makes it the tool for scripts and agents.

Open the desktop

kiste desktop

Your browser opens the Kiste's GNOME desktop at desktop.kiste.run. The link works only in browsers signed in to your account. Desktop explains the viewer.

Stop it

kiste stop --snapshot

The Kiste saves its memory and stops; it uses no compute while stopped. Bring it back exactly as it was:

kiste start my-first-kiste

Without --snapshot, kiste stop shuts down cleanly and the next start is a fresh boot from the same disk.

What next

  • Shell completions that know your Kisten by name: source <(kiste completions zsh) in ~/.zshrc.
  • Reach Kisten from ssh, scp and VS Code: SSH configuration and editors.
  • Publish a web app: kiste stream 3000, see Kiste Stream.
  • Everything about Kisten: Kisten.

On this page