Troubleshooting

Start with the error printed by DS Plane, then use the matching section below.

The dsplane command is not found

Confirm that your package manager’s global binary directory is on PATH. Reopen the terminal after a global installation, then run:

dsplane --version

For Deno installations, the default global binary directory is ~/.deno/bin.

Browser login times out

DS Plane waits 180 seconds for the landscape callback on port 55532.

1. Confirm the browser is authenticated to the same landscape.
2. Check whether another process is using port 55532.
3. Allow localhost connections through local firewall software.
4. Use the /jwt URL shown in the TUI and paste the token manually.

A saved JWT is requested again

The JWT may be expired, invalid, or unavailable from the system credential service. Authenticate again. In a headless Linux environment without a Secret Service backend, approve the plaintext fallback if you need the token across processes.

The landscape configuration is invalid

landscape-config.json must be a JSON array containing unique normalized landscape entries:

[
  {
    "url": "https://example.applicationstudio.cloud.sap/"
  }
]

When a plaintext JWT was explicitly approved, the same object also contains a jwt string. Correct or remove malformed data at the path listed in Configuration and authentication.

SSH connection problems

Confirm:

• The Dev Space is running and has SSH enabled.
• ssh is available on PATH.
• The generated key in ~/.ssh is readable only by your user.
• Localhost ports are not blocked by security software.

OpenSSH may reject a key with permissive permissions. On Unix systems:

chmod 600 ~/.ssh/<workspace-id>.key

An SSH alias no longer works

Inspect the matching Host section in ~/.ssh/config. The ProxyCommand must point to the currently installed DS Plane executable and include the correct landscape and Dev Space display name.

You can reconnect through interactive mode and save the alias again.

IDE does not open

Run:

dsplane ide --options

Then confirm that the selected IDE is in the implemented IDE list and its command is available on PATH. DS Plane reports a not-implemented error for recognized identifiers without an opener.

A subcommand cannot find the Dev Space

The --devspace value is the Dev Space display name. Check spelling and the selected --landscape URL. Use interactive mode to see the names returned by the landscape.

Report an issue

Include the command, platform, DS Plane version, and sanitized error output in a GitHub issue. Do not include JWTs or private keys.