Setting Up SAP BTP and Kyma Runtime for Deployment

Beginner

30 min.

SAP CAP Operator, Kubernetes environment, Beginner, Node.js, Cloud Operations, SAP Cloud Application Programming Model, Tutorial, SAP Business Technology Platform, SAP BTP, Kyma runtime

Learn how to set up the SAP BTP, Kyma runtime for deploying the application.

You will learn

How to configure entitlements.
How to enable the SAP BTP Kyma runtime in your subaccount in SAP BTP.
How to create an SAP HANA Cloud service instance in the SAP BTP cockpit.

Anirudh PrasadMarch 31, 2026

Created by

March 27, 2026

Contributors

Prerequisites

You have an enterprise global account in SAP BTP. To use services for free, you can sign up for an SAP BTPEA (SAP BTP Enterprise Agreement) or a Pay-As-You-Go for SAP BTP global account and use the free tier services only. See Using Free Service Plans.
You have a platform user. See User and Member Management.
You’re an administrator of the global account in SAP BTP.
You have a subaccount in SAP BTP to deploy the services and applications.

This tutorial follows the guidance provided in the SAP BTP Developer’s Guide.

Step 1

To deploy the Incident Management sample application, you need the following entitlements:

Service	Plan	Quota required
Kyma runtime	free (Environment)	1
SAP HANA Cloud	hana-free	1
SAP HANA Cloud	tools (Application)	1
SAP HANA Schemas & HDI Containers	hdi-shared	1
HTML5 Application Repository Service	app-host	1
HTML5 Application Repository Service	app-runtime	1
Destination Service	lite	1
SaaS Provisioning Service	application	1
Service Manager	container	1
Authorization and Trust Management Service	broker	1

You can find more information about entitlements in Configure Entitlements and Quotas.

Step 2
Let’s enable your subaccount to use the SAP BTP, Kyma runtime.

Navigate to your subaccount and choose Enable Kyma under the Kyma Environment tab.

In the Enable Kyma popup, change the values for Instance Name and Cluster Name as needed and choose Create.

Make sure that the instance name is CLI-friendly. CLI-friendly names make it easier to manage your instances with the SAP BTP command-line interface as well.

A CLI-friendly name is a short string (up to 32 characters) that contains only alphanumeric characters (A-Z, a-z, 0-9), periods, underscores, and hyphens. It can’t contain white spaces.

When enabling the runtime, you notice that the instance name is generated automatically for you. You can use that name or replace it with the name of your choice.
Step 3
Navigate to your subaccount and choose Services → Service Marketplace on the left.

Type SAP HANA Cloud in the search box and choose Create.

In the New Instance or Subscription popup, select tools from the dropdown in the Plan field and choose Create.

Choose View Subscription and wait until the status changes to Subscribed.

In your SAP BTP subaccount, choose Security → Role Collections in the left-hand pane.

Choose role collection SAP HANA Cloud Administrator.

Choose Edit.

In the Users section, enter your user and select the icon to add the user.

Keep the Default Identity Provider setting unless you have a custom identity provider configured.

Choose Save.

You’ve assigned the SAP HANA Cloud Administrator role collection to your user.

Log out and log back in to make sure your new role collection is considered.
Step 4
SAP HANA Cloud is used as a persistence layer.

Follow these steps to create an SAP HANA Cloud service instance in the SAP BTP cockpit:

In your SAP BTP subaccount, navigate to Services → Instances and Subscriptions in the left-hand pane.

Choose SAP HANA Cloud. You’re redirected to SAP HANA Cloud multi-environment administration tools. Sign in with your SAP BTP cockpit username/email if necessary.

In SAP HANA Cloud Central, choose Create Instance.

Choose Confiure manually as Instance Configuration and SAP HANA Database as Instance Type. Then, choose Next Step.

In the Instance Name field, enter application-hana-instance.

In the Administrator Password and Confirm Administrator Password fields, enter a password for DBADMIN. Choose Next Step.

At SAP HANA Database: Size and Availability, choose Next Step.

In SAP HANA Database: Connections, select the All IP addresses radio button, and choose Next Step.

At SAP HANA Database: Advanced Settings, choose Next Step.

At Data Lake: General, choose Review and Create.

Choose Create Instance.

The creation of the database instance can take some minutes to complete.

Your SAP HANA Cloud service instance automatically stops overnight, according to the time zone of the region where the server is located. This means you need to restart your instance every day before you start working with it.
Step 5
Go to SAP HANA Cloud Central. If you’ve closed it, open it again by following these steps:

In your SAP BTP subaccount, navigate to Services → Instances and Subscriptions.

Choose SAP HANA Cloud. You’re redirected to SAP HANA Cloud multi-environment administration tools. Sign in with your SAP BTP cockpit username/email if necessary.

For the application-hana-instance instance, choose Manage Configuration.

Select the Instance Mapping tab and choose Add Mapping.

Select Kyma from the dropdown under Environment Type.

Under Environment Instance ID, paste the GUID of your Kyma cluster. Here’s how to find it:

Open your Kyma dashboard.

Choose Namespaces on the left and choose kyma-system.

Navigate to Configuration → Config Maps and choose sap-btp-operator-config.

You can see the GUID of your Kyma cluster in the CLUSTER_ID section.

If no namespace is provided, the instance is mapped to all namespaces in the cluster.

Choose Review and Save. In the popup, choose Save Changes.

You’ve mapped your SAP HANA Cloud service instance to your Kyma cluster.

For more information, see Map an SAP HANA Database to another Environment Context to add a new Cloud foundry or Kyma mapping.