Create or bring a Kubernetes cluster
Install Keptn on your Kubernetes cluster and expose it
Home / Keptn v1 Docs / Release 1.y.z / Installation
How to install and configure your Keptn environment. Scroll down for a reference list of tasks.
Install Keptn on your Kubernetes cluster and expose it
Keptn and Kubernetes compatibility overview and required cluster size.
Choose the method to use to access Keptn
Install binaries for the Keptn CLI
Install Keptn on a single cluster using the Helm chart
Install Keptn control-plane and execution-plane on separate clusters
Authenticate the Keptn CLI and Bridge to your Keptn cluster
Install the Job Executor Service to run Keptn customizable tasks as Kubernetes jobs
Configure Istio and create a ConfigMap to expose services deployed by Keptn.
Install service to attach observability platform as data source for quality gates
Configuration for Webhook Service.
Tips for troubleshooting installation problems.
Upgrade your Keptn
Uninstall Keptn from a Kubernetes cluster.
The steps to install and configure your Keptn instance are:
Keptn can run on existing Kubernetes clusters or you can create a Kubernetes cluster just for Keptn.
Decide how you want to access Keptn. Kubernetes supports exposing Keptn via a LoadBalancer, a NodePort, an Ingress or using Port-forwarding. You need this information when you install Keptn.
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:
Install software to run Keptn tasks
If your project does Deployment with Helm, install 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: