DS Plane CLI
DS Plane CLI

Get started

Quickstart

Install DS Plane CLI, add a Business Application Studio landscape, and open a Dev Space.

This guide installs DS Plane, authenticates to a landscape, and opens the interactive Dev Space menu.

Prerequisites

  • Access to an SAP Business Application Studio landscape.
  • Permission to view its Dev Spaces.

Install the CLI

Choose the package manager already available on your system.

Confirm that the executable is available:

dsplane --version

Add a landscape

Start interactive mode:

dsplane

On the first run, DS Plane asks for a landscape URL. Paste any URL from the landscape. DS Plane reduces it to the HTTP or HTTPS origin, so paths such as /index.html do not need to be removed first.

https://example.applicationstudio.cloud.sap/

Authenticate

Select the landscape and confirm the browser login prompt. DS Plane:

  1. Opens the landscape’s external login page.
  2. Listens for the login callback on local port 55532.
  3. Stores the returned JWT in your system credential service when one is available.

If the browser cannot return the JWT, DS Plane shows the landscape’s /jwt URL and accepts a pasted token.

When no system credential service is available, DS Plane asks whether it may store the JWT in the local landscape configuration. Declining keeps the token for the current process only.

Open a Dev Space

Select a Dev Space to view the actions available for its current state. A stopped Dev Space can be started. A running Dev Space can be opened, stopped, deleted, or connected to through the available connection options.

DS Plane is ready when the Dev Space selection screen lists the environments available to your account.

Next steps