The Keptn CLI is not Keptn itself but is instead an interface to Keptn, much as kubectl is an interface to Kubernetes. Install it on the local machine that is used to interact with your cloud provider, Kubernetes, etc.
The Keptn CLI sends commands to Keptn by interacting with the Keptn API. The API Token that is used to communicate with Keptn is generated during the installation.
It is possible to run Keptn without installing the Keptn CLI. Current Keptn releases allow you to create a project or run a sequence using the Keptn Bridge, and this may be adequate for demos or personal environments you set up for study. But the CLI is required for some functionality and it should be installed on production systems.
You can install the Keptn CLI using:
You can use the
curl command to install the Keptn CLI on Linux, WSL2, and macOS.
Windows users need
awk installed (e.g., using Git Bash).
Download the latest stable Keptn version
unpack it, and install on your machine,
curl -sL https://get.keptn.sh/ | bash
Use sudo to move the file to another location.
Verify that the installation has worked and that the version is correct. On Linux and macOS, run:
On Windows, run:
Run the following command to automatically fetch the latest Keptn CLI via Homebrew:
brew install keptn
Verify that the installation has worked and that the version is correct by running:
To upgrade Keptn CLI to a new release, run:
brew upgrade keptn
To uninstall Keptn CLI, run:
brew uninstall keptn
Each release of Keptn provides binaries for the Keptn CLI. These binaries are available for Linux, macOS, and Windows. To install the Keptn CLI from the binaries:
Download the version matching your operating system.
Unpack the archive.
keptn binary in the unpacked directory.
For Linux / macOS:
chmod +x keptn
keptnbinary to the desired destination For example,
mv keptn /usr/local/bin/keptn
Verify that the installation has worked and that the version is correct.
On Linux or MacOS, run:
On Windows, run:
After you install both the Keptn CLI and Keptn itself, you must authenticate the CLI. See Authenticate Keptn CLI and Bridge.