Technology Blogs by SAP
Learn how to extend and personalize SAP applications. Follow the SAP technology blog for insights into SAP BTP, ABAP, SAP Analytics Cloud, SAP HANA, and more.
Showing results for 
Search instead for 
Did you mean: 
Product and Topic Expert
Product and Topic Expert

This video tutorial series shows getting started with the SAP Business Technology Platform, Kyma environment covering prerequisites, procedure (how-to), result, and next steps using both the web console and command line tools for automation.

For the video tutorials about extending SAP solutions, see

For some background information about container engines, orchestration, Kubernetes, Kyma open source and the SAP Business Technology Platform Kyma runtime, see

For information about DIY Kyma deployments, see

For more partner-focused hands-on developer series, see

To be informed when new posts are published about partner-related content in the video tutorials series, follow tag

Questions? Please post as comment.

Useful? Give us a like and share on social media.


On Your Marks

Getting Started

Before we can deploy our first microservice-in-a-container or function-as-code into the Kyma runtime, we (administrators, that is), first need to set things up. In this article, we cover all the required steps starting with the documentation (always be prepared)

  • Prerequisites: subaccounts and entitlements

  • Create service instance

  • Assign role collections

  • Register SAP system(s)

The focus of the documentation is on using the SAP BTP Cockpit web user interface. In this tutorial series we will also show you how we can achieve the same result using the SAP BTP CLI (command line interface).

The tutorial series assumes you have done your SAP BTP onboarding. If not, take a look at


For the optional command line equivalents, you only need to be familiar with the basics.
btp help
btp --info
btp login
btp target

For the BTP command line tool, see

YouTube Playlist

For the complete playlist, visit the SAP HANA Academy channel on YouTube



Video Tutorial

In this video tutorial we provide an introduction to the SAP Business Technology Platform, Kyma runtime (SKR), using the information published to the SAP Help Portal, the Kyma project website, and the SAP Discovery Center.

Time Markers

0:00 - Introduction

0:30 - SAP Help Portal

1:15 - Kyma Project

3:20 - BTP Regions

4:20 - Setup and development information

5:00 - Tutorials

6:20 - Discovery Center


For the mentioned resources, see

Subaccounts and Entitlements

Video Tutorial

In this video tutorial we provide an introduction to the SAP Business Technology Platform, Kyma runtime (SKR), covering the requirements for the runtime: subaccounts and entitlements using the SAP BTP cockpit console and the SAP BTP CLI.

Time Markers

0:00 - Introduction

0:35 - SAP BTP Cockpit

1:10 - Service assignments

2:00 - Create subaccount

3:00 - Create subaccount using BTP CLI

3:30 - Entity assignments

4:20 - Assign accounts entitlements using BTP CLI

BTP CLI Commands

To create subaccounts
# create a subaccount
# regions: ap, br, ca, eu, jp, us,
# providers: 10 (aws), 20 (azure), 30 (gcp)
btp create accounts/subaccount
--display-name cf-eu20 --region eu20 --subdomain cf-eu20-qwerty

To assign entitlements
# query subaccount ID(s)
btp list accounts/subaccount

# assign entitlements
# plan = aws, azure, gcp
btp assign accounts/entitlement
--to-subaccount xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx
--for-service kymaruntime --plan aws --amount 1

# list entitlements
btp list accounts/entitlement
--subaccount xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx


About the plans, see

For the available regions, see the SAP Discovery Center

The Kyma runtime was initially hosted from Azure data centers. In 2021, AWS and GCP were added. Note that the region where the Kubernetes cluster can be deployed may differ from the region where the subaccount was created, e.g. for GCP US Central (Iowa),

For sizing information, see

Create Service Instance

Video Tutorial

In this video tutorial we provide an introduction to the SAP Business Technology Platform, Kyma runtime (SKR) and create a service instance of the Kyma runtime using the SAP BTP cockpit and the BTP CLI.

Time Markers

0:00 - Introduction

0:30 - SAP BTP Cockpit Subaccount Overview

1:30 - Service Marketplace

1:45 - Create instance dialog

4:20 - AWS, Azure, GCP

5:45 - Create instance

7:00 - BTP CLI

BTP CLI Commands

Although we can pass JSON on the command line by escaping the double quotes with a backslash, using a file is recommended.

Name is a required parameter, region, and machine type are optional and default to the smallest type (in case of Azure a single type is available).
"name": "give-the-cluster-a-name",
"region": "europe-west3",
"machineType": "n2-standard-8"

To create an service instance
# list subaccounts for ID
btp list accounts/subaccount

# create Kyma runtime
btp create accounts/environment-instance
--subaccount xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx
--environment kyma --service kymaruntime --plan azure
--parameters azure.json

# list all environment instances
btp list accounts/environment-instance
-sa xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx

# get details for single environment instances
btp get accounts/environment-instance <ID>
-sa xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx

# delete an environment instance
btp delete accounts/environment-instance <ID>
-sa xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx


For the documentation, see

Security > Role Collections

Video Tutorial

In this video tutorial we provide an introduction to the SAP Business Technology Platform, Kyma runtime (SKR) and show how to assign the Kyma Runtime Namespace Admin and Developer role collections to a user using the SAP BTP Cockpit and the BTP CLI. We also download the kubeconfig configuration file and access the Kubernetes cluster using kubectl.

Time Markers

0:00 - Introduction

0:45 - Roles and Role Collections

2:00 - Kyma Dashboard - Add new namespace

3:20 - Download Kubeconfig

4:00 - Kubectl delete namespace

4:20 - BTP CLI

BTP CLI Commands

To (un)assign user to (from) role collections, the following commands can be used.
# list roles for subaccount
btp list security/role
-sa xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx

# list role collections for subaccount
btp list security/role-collection
-sa xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx

# assign role collection to user
btp assign security/role-collection KymaRuntimeNamespaceAdmin___x_xxxxxx
-sa xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx

# unassign role collection to useress
btp unassign security/role-collection KymaRuntimeNamespaceAdmin___x_xxxxxx
-sa xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx

Kubectl Commands

To connect to the Kyma (Kubernetes) cluster, download the kubeconfig YAML file from the Kyma Dashboard. When using a non-default location, you can define the path to the kubeconfig file as environment variable (see references).
export KUBECONFIG=path_to/kubeconfig.yml
kubectl version --short

You can use the Kyma Dashboard web UI or the kubectl command line tool to create, change, and delete namespaces.

As a managed service, the Kubernetes and Kyma system namespaces are not accessible.
# namespace (ns)
kubectl get ns
kubectl describe ns
kubectl delete ns


For information about kubeconfig, see

For information about how to download kubectl, see

For older versions (compatible with the Kyma (Kubernetes) cluster, try

For information about Kubernetes namespaces, see

For the role and role collection documentation, see

Extending SAP Cloud Solutions

SAP Extension Center

With the SAP BTP, Kyma environment up and running, we can proceed with the integration of (one or more) SAP Cloud solutions.

Video Tutorial

For the video tutorials about extending the Kyma runtime, see


For the documentation, see

SAP Developers Tutorials

For a tutorial explaining how to deploy an SAP Commerce mock application to the Kyma runtime, see

Share and Connect

Questions? Please post as comment.

Useful? Give us a like and share on social media.


If you would like to receive updates, connect with me on

For the author page of SAP PRESS, visit

Over the years, for the SAP HANA Academy, SAP’s Partner Innovation Lab, and à titre personnel, I have written a little over 300 posts here for the SAP Community. Some articles only reached a few readers. Others attracted quite a few more. For your reading pleasure and convenience, here is a curated list of posts which somehow managed to pass the 10k-view milestone and, as sign of current interest, still tickle the counters each month.