Overview
You will learn
- How to group images with
:::figureand reference an inline:image - How to show before/after comparisons with
::compareand architecture with::diagram - How to annotate a screenshot with image hotspots and embed a screencast with
::cast - How to mark a table sortable and filterable
Prerequisites
- An SAP BTP trial or productive account
- The Cloud Foundry CLI installed (
cf --version≥ 8) - The
@sap/cds-dkpackage installed globally (npm i -g @sap/cds-dk) - A modern browser (Chrome, Edge, or Firefox)
Steps
Before you deploy, familiarise yourself with the main areas of the SAP BTP Cockpit. Two views are most important: the Global Account overview and the Subaccount detail.


In the global account view you manage entitlements across all subaccounts. Drill into a subaccount to see its spaces, service instances, and routes.
To reach the subaccount overview, click
next to the subaccount name, or click the name itself.
Run the following commands to log in to Cloud Foundry and point the CLI at the space where you will deploy.
cf login -a https://api.cf.eu10-005.hana.ondemand.com --sso
cf target -o <your-org> -s devAfter login, the terminal confirms the API endpoint, organisation, and space. The comparison below shows the difference between a first-time login (which prompts for SSO) and a subsequent re-authentication (which reuses a cached token).


The diagram below shows how the three tiers of a standard CAP application map to BTP Cloud Foundry components after deployment.
The key connection points are:
- The AppRouter authenticates users via XSUAA and proxies requests to the CAP service.
- The CAP service (
tutorials-srv) serves OData endpoints and reads/writes data through the HDI container binding. - SAP HANA Cloud stores all business data; the HDI container manages schema migrations.
Now annotate this on a real screenshot to see exactly where each component appears in the BTP Cockpit.

- The AppRouter (
tutorials-approuter) — the public-facing entry point. Check that it shows 1/1 running instances. - The CAP service (
tutorials-srv) — the backend API. It should also show 1/1 running instances. - The HANA Cloud service instance (
tutorials-hana) in the service instances list — bound to both apps.
Run the Multi-Target Application (MTA) build and deploy commands. The recording below shows a complete mbt build + cf deploy sequence on a minimal CAP project.
► Loading terminal recording…
If the deploy fails with No credentials configured for HDI container, the HANA service binding is missing. Bind it manually:
cf bind-service tutorials-srv tutorials-hana
cf restart tutorials-srvAfter deploy completes, open the AppRouter URL and confirm that each surface is reachable.
| Surface | URL pattern | Expected response |
|---|---|---|
| Root | https://<approuter>/ | Redirects to /browse |
| OData metadata | https://<approuter>/srv/catalog/$metadata | Returns EDMX XML |
| Admin UI | https://<approuter>/admin-ui/ | Requires Tutorial.Admin scope |
| Health check | https://<srv-direct>/health | { "status": "UP" } |
The table above lists all surfaces you should verify. Use the filter box to narrow by surface name, or click the URL pattern column header to sort alphabetically.
Congratulations — your CAP application is live on SAP BTP Cloud Foundry.
Resources
Discussion
Share feedback on this tutorial or join the conversation in SAP Community.