Install Kaptain

Install Kaptain on your cluster

IMPORTANT: Refer to the Kaptain fresh install instructions, if you already have Kaptain and want to move from 1.x to 2.x. Note that it is not possible to migrate your data.

How do you want to deploy Kaptain?

You can install Kaptain:

  • On public cloud infrastructure, such as Amazon Web Services (AWS), Microsoft Azure, or Google Cloud Platform (GCP).
  • On a company-internal network with a physical (bare metal) or virtual infrastructure.
  • On a company-internal network or VPC (virtual private cloud) without an internet connection: air-gapped/private/offline clusters.

The infrastructure you select determines the specific requirements for a successful installation.

Before you begin

Kaptain is a DKP Catalog application. To use it, add it to your repository and then deploy it on selected workspaces. No downloads are necessary for networked environments. For users deploying to air-gapped environments, refer to the download page.

You can deploy Kaptain to single and multi-cluster environments. The difference between these setups is the following: In a single-cluster environment (with an Essential license), you deploy on one Management cluster only. In a multi-cluster environment (with an Enterprise license), Kaptain is deployed to either one or several Managed clusters or to Attached clusters.

You can deploy Kaptain on a per-workspace basis.

WARNING: You can deploy Kaptain to a cluster in a selected workspace. If you do not intend to deploy Kaptain to a certain cluster, you must switch the workspace you are deploying to or move that cluster to another workspace.


  • A DKP cluster with the following Platform applications enabled:

    • Istio
    • Knative (optional, if KServe is configured to work in RawDeployment mode)
  • kubectl on your installation machine

Install overview

To install and deploy Kaptain for the first time, proceed with these steps:

  1. Add Kaptain to your DKP Catalog applications in a networked environment,

    Add Kaptain to your DKP Catalog applications in an air-gapped environment for DKP 2.1,


    Add Kaptain to your DKP Catalog applications in an air-gapped environment for DKP 2.2.

  2. Deploy Kaptain on a per-Workspace basis and verify the status of deployment.