Preparing Your Environment For SAP BTP Development on Kyma Runtime

In this blog post, we will walk you through the steps to set up your environment for SAP BTP development on the Kyma runtime. We will cover the prerequisites, installation of necessary tools, and configuration of your development environment.

This post is part of a series on SAP BTP Kyma Runtime development:

Series — SAP BTP Kyma Runtime:

  1. Preparing Your Environment For SAP BTP Development on Kyma Runtime (this post)
  2. Deploying Your First CAP Application on SAP BTP Kyma Runtime
  3. Creating BTP Service Instances on SAP BTP Kyma Runtime with the Service Operator
  4. Binding BTP Service Instances to your CAP Application with Kyma Runtime
  5. The Chart Templates Behind Your CAP Kyma Deployment
  6. Creating roles for your CAP Application on SAP BTP Kyma Runtime
  7. Using Istio Gateway as Entry Point in SAP BTP Kyma Runtime

Prerequisites

Before you begin, ensure you have completed the following prerequisites:

  1. An active SAP BTP account with Kyma runtime enabled.

Follow the instructions here to enable the Kyma runtime, and here to assign the necessary roles for your user. For a guided tutorial on creating a Kyma environment instance, refer to the Prepare for Deployment in the SAP BTP, Kyma Runtime.

  1. Entitlements for the required services in your SAP BTP subaccount.

Follow the instructions here to check and manage your entitlements.

  1. A container registry (e.g., Docker Hub, GitHub Container Registry, Azure Container Registry, etc.) to store your container images.

Install Required Tools

To develop on the Kyma runtime, you will need to install the following tools:

  1. kubectl: The command-line tool for interacting with Kubernetes clusters.

    • Installation instructions can be found here.

    For MacOS you can install it via Homebrew running:

    Copy
     brew install kubectl
  2. Docker: The platform for developing, shipping, and running applications in containers.

    • Installation instructions can be found here.
  3. Helm: The package manager for Kubernetes.

    • Installation instructions can be found here.

    For MacOS you can install it via Homebrew running:

    Copy
     brew install helm
  4. kubelogin: A tool to manage Kubernetes authentication.

    • Installation instructions can be found here

    For MacOS you can install it via Homebrew running:

    Copy
     brew install int128/kubelogin/kubelogin
  5. Paketo Build: A tool for building container images from source code.

    • Installation instructions can be found here.

    For MacOS you can install it via Homebrew running:

    Copy
    brew install buildpacks/tap/pack

Log in to the Kyma Cluster

Once you have installed the required tools, you need to log in to your Kyma cluster. To do this, follow these steps:

  1. Download the kubeconfig.yaml file for your Kyma cluster from the SAP BTP cockpit.

    • BTP cockpit > Subaccount > Kyma Environment > KubeconfigURL

    Download Kubeconfig

  2. Copy the kubeconfig.yaml file you just downloaded to the ~/.kube/ directory and rename it to config. If there is already a config file in that directory, you can either back it up or replace it with the new one.

  3. Use kubectl to verify that you are connected to the correct cluster:

    Copy
    kubectl cluster-info
  • This will fire the authentication process and open a browser window for you to log in with your SAP BTP credentials. After logging in, you should see information about your cluster. Cluster Info

Published

July 14, 2026

Topics