Skip to content

Setup in Cloud Foundry

Deploy Eclipse Dirigible in SAP BTP1, Cloud Foundry environment.



  1. Set the SAP BTP Cloud Foundry API host:

    cf api <cloud-foundry-api-host>
  2. Log in to the SAP BTP, Cloud Foundry environment with:

    cf login
  3. Deploy Eclipse Dirigible:

    cf push dirigible \
    --docker-image=dirigiblelabs/dirigible-sap-cf:latest \
    --hostname dirigible-<org-name> \
    -m 2G -k 2G
    Replace the <org-name> placeholder with your subaccount's Subdomain value.

    Eclipse Dirigible versions

    Instead of using the latest tag (version), for production and development use cases it is recomended to use a stable release version:

    • All released versions can be found here.
    • All Eclipse Dirigible Docker images and tags (versions) can be found here.
  4. Create XSUAA service instance:

    • Copy and paste the following content into xs-security.json:

         "xsappname": "<applicationName>-xsuaa",
         "tenant-mode": "shared",
         "scopes": [
               "name": "$XSAPPNAME.Developer",
               "description": "Developer scope"
               "name": "$XSAPPNAME.Operator",
               "description": "Operator scope"
         "role-templates": [
               "name": "Developer",
               "description": "Developer related roles",
               "scope-references": [
               "name": "Operator",
               "description": "Operator related roles",
               "scope-references": [
         "role-collections": [
               "name": "dirigible",
               "description": "Dirigible Developer",
               "role-template-references": [

      Replace the <applicationName> placeholder with your application name, e.g. dirigible.

    • Create a XSUAA service instance:

      cf create-service xsuaa application <applicationName>-xsuaa -c xs-security.json

      Use the same <applicationName> as in the previous step.

  5. Bind the XSUAA service instance to the Eclipse Dirigible deployment:

    • Bind the service instance:

      cf bind-service dirigible <applicationName>-xsuaa

      Replace the <applicationName> placeholder with the application name used in the previous steps.

    • Restart the dirigible deployment:

      cf restart dirigible
  6. Assign the Developer and Operator roles.

  7. Log in.

Additional Materials

  • For deployment through manifest.yaml follow these steps.
  • A step-by-step tutorial can be found here.

  1. SAP Cloud Platform is called SAP Business Technology Platform (SAP BTP) as of 2021.