For AI agents: the complete documentation index is available at https://www.jumpserver.com/docs/llms.txt, the full documentation bundle is available at https://www.jumpserver.com/docs/llms-full.txt, and this page is available as Markdown at https://www.jumpserver.com/docs/features/client/asset-connection.md.
๐ŸŽ‰ JumpServer v5.1.1 is available. See what's new โ†’

Asset Connection

Enterprise Edition

Desktop database, RDP, VNC, RemoteApp, and VirtualApp connections require JumpServer Enterprise Edition. Desktop SSH and SFTP connections are included in Community Edition.

Request 14-day free trial

JumpServer Client lists the assets authorized to your account. Open an asset, choose a protocol and account, and confirm the connection.

Prerequisites

  • JumpServer Client is installed and you are signed in.
  • You have an authorization for the asset and account.
  • For database or application connections, the local client path is configured.

Unified connection entry

New in v5.0.0

The client uses a unified entry point for SSH, RDP, Kubernetes, database, and RemoteApp assets. Select any of these assets from the same client asset list and choose the protocol, account, and connection method. The connection opens in the client window, and the same authorization and ACL rules apply as for the Web Terminal.

Kubernetes assets open the Kubernetes workspace. RemoteApp assets open a published remote application, and the RemoteApp connection requires JumpServer Enterprise Edition. SFTP Server connections use the same entry but open a file session; see Workspace, Files, and Scripts.

Figure 1: Unified connection entry with JumpServer Client.

Connect to a Linux asset

  1. Find the Linux asset in the client asset list.
  2. Select Connect next to the asset name.
  3. Choose a protocol: SSH, SFTP, or VNC.
  4. Select an authorized account.
  5. Select Confirm.

After connecting, run commands and upload or download files in the session.

Figure 2: Linux asset connection dialog with SSH and SFTP options.

Connect to a Windows asset

  1. Select Connect next to the Windows asset.
  2. Choose RDP, VNC, SSH, or SFTP.
  3. Select the account and confirm the connection.

The available protocols depend on the asset platform and the enabled components.

Figure 3: Windows asset connection dialog with RDP and WINRM options.

Connect to a Kubernetes asset

New in v5.0.0

Kubernetes cloud assets use the k8s protocol. Connect to them from the same client asset list:

  1. Select Connect next to the Kubernetes asset.
  2. Select the authorized account.
  3. Select Confirm.

The Kubernetes workspace opens in the client, with a resource browser for the Kubernetes resources you are authorized to see and a terminal for the selected container.

Connect to a database asset

Changed in v5.1.0

Database assets use a local database client. Configure the application path once:

  1. Open the client settings.
  2. Select Database and choose the database type, for example MySQL.
  3. Download and install a supported database application if needed.
  4. Select Select path and choose the installed application.

Then connect to the database asset from the asset list. The connection opens in the configured local client.

DBX replaces DBeaver as the default remote database application for these connections. To use a different database application, configure its executable path in Connection Settings.

Figure 4: Database connection dialog for a PostgreSQL asset with Built-in terminal and Database workbench options.

Connect to a web asset

Web assets use the platform type Website and the HTTP or HTTPS protocol.

  1. Select Connect on the web asset.
  2. Choose Built-in > Built-in browser.
  3. Confirm the connection.

The site opens in a WebView window, and traffic is forwarded through the JumpServer Web proxy. The built-in browser is available only in JumpServer Client; the browser Web terminal uses a published WebLite application instead.

Figure 5: Web asset connection dialog with the built-in browser selected.

The site address and account are configured by the administrator on the Web asset; the client does not provide an edit entry.

Notes

  • Connection methods and protocols depend on the asset platform, enabled components, license, and the account authorization.
  • If an asset or account is missing, ask an administrator to review your authorization.

Version history

VersionChange
v5.1.0Changed the default remote database application to DBX.
v5.0.0Added a unified connection entry for SSH, RDP, Kubernetes, database, RemoteApp, and web assets.
v5.0.0Added Kubernetes connections from the client asset list.