Note: Keptn v1 is not compatible with ARM-based machines (eg. Mac M1 and M2) due to the use of the Bitnami MongoDB which isn’t built for ARM. We recommend the newer Keptn Lifecycle Toolkit instead.

The steps to install and configure your Keptn instance are:

Create or bring a Kubernetes cluster
- Check Kubernetes support and cluster size to ensure that your version of Kubernetes is compatible with the Keptn version you are installing and that you have adequate resources.
Decide how you want to access Keptn. Kubernetes supports exposing Keptn via a LoadBalancer, a NodePort, an Ingress or using a Port-forward.
Install Keptn CLI on the cloud shell machine that is used to access your cloud provider, Kubernetes cluster, etc (recommended).
Install the Helm CLI.
Install Keptn using a Helm chart
- All on one cluster
- Install using a Multi-cluster setup, meaning that the Keptn Control Plane is installed in one Kubernetes cluster and the Keptn Execution Plane is installed in one or more other Kubernetes clusters.
Authenticate CLI and Bridge
Install software to run Keptn tasks
- Job Executor Service
  - The Job Executor Service runs Keptn customizable tasks as Kubernetes jobs. See Job Executor Service Features for more details.
  - Also see Job Executor Service Architecture
- Istio
If you are using Quality Gates, install the monitoring service you want to use.
Configure webhooks (optional)
If you have problems with your installation, check out the hints in Troubleshooting the installation

You may also be interested in the following topics: