Skip to content
These docs are a preview of Self-Managed Kindo 2026.11, an upcoming release.

Update the Kindo CLI

Each CLI installs its own version. Replace the version placeholder with the version you want, such as 2026.11.0. Install it as the user who runs it, not as root. The workstation needs the tools that Check your workstation lists.

Log in with the registry username and password Kindo provided:

Terminal window
helm registry login registry.kindo.ai --username '<registry-username>'

Download the CLI:

Terminal window
download="$(mktemp -d)"
helm pull oci://registry.kindo.ai/kindo-cli/kindo-cli --version <version> --untar --untardir "$download"

Check the download. On Linux:

Terminal window
(cd "$download/kindo-cli" && sha256sum -c SHA256SUMS)

On macOS:

Terminal window
(cd "$download/kindo-cli" && shasum -a 256 -c SHA256SUMS)

With uv (recommended), install the CLI:

Terminal window
uv tool install --force "$download"/kindo-cli/kindo_cli-*.whl

Check its version. It should report the version you downloaded.

Terminal window
kindo --version

If it reports another version, or the command isn’t found, put uv’s tool folder first on your path:

Terminal window
export PATH="$HOME/.local/bin:$PATH"

Without uv, do the rest of this step instead. Check that Python is 3.11 or newer:

Terminal window
python3 --version

Install with uv instead if it’s older.

Create a Python environment for the CLI. On Debian or Ubuntu, install the Python venv package first:

Terminal window
sudo apt-get install python3-venv
Terminal window
python3 -m venv "$HOME/.kindo-cli"

Install the CLI into it:

Terminal window
"$HOME/.kindo-cli/bin/pip" install "$download"/kindo-cli/kindo_cli-*.whl

Put the CLI on your path by adding its folder to the front:

Terminal window
export PATH="$HOME/.kindo-cli/bin:$PATH"

Check its version. It should report the version you downloaded.

Terminal window
kindo --version

To keep CLIs for several versions on one workstation, such as the 2026.09 CLI for a rollback, give each its own folder. After you download and check the CLI as Update or switch the CLI describes, install that version into its own folder with uv and run it from there:

Terminal window
version=<version>
UV_TOOL_DIR="$HOME/.kindo/$version/tools" UV_TOOL_BIN_DIR="$HOME/.kindo/$version/bin" \
uv tool install "$download"/kindo-cli/kindo_cli-*.whl
"$HOME/.kindo/$version/bin/kindo" --version