Launch an RDP session in a web client

Launch RDP connections and other session types directly from the browser via the Devolutions Server web interface.

Based on IronRDP (Rust implementation of the RDP protocol) and its web assembly component, the web client, passing through a Devolutions Gateway, ensures a secure communication using the protocol directly. Unlike Apache Guacamole, no intermediate protocol is used and unlike RD Web Access, there is no redundant extra TLS layer. This ensures good performance.

Requirements

To use this feature, certain requirements must be met, namely:

  • Windows 10 or 11.
  • Windows Server 2016 and later.
  • Have a Devolutions Gateway version 2023.1 or later.
  • Have a Devolutions Server version 2023.1.3 or later.
  • Have an RDP type connection with a gateway type VPN configured.
  • Have the View password permission if you are the one to use the session.
    • When using IronRDP, a call is generated to the tool, and the password can be seen when the developer tools are enabled.
  • Have a Remote Desktop Manager or Devolutions Launcher license assigned to the user who will launch the session.

Supported session entries

Other session entry types can be launched via the Devolutions Server web interface:

  • Active Directory
  • Apple Remote Desktop (ARD)
  • PowerShell (remote)
  • RDP (Microsoft Remote Desktop)
  • SSH terminal
  • Telnet
  • VNC

RDP session configuration

Follow the steps below to properly configure your RDP session to launch it in a browser:

The steps below assume that you already have an RDP session entry. If you have not yet created it and want to learn how, see Create entries manually.

  1. In the Devolutions Server web interface, go to the Properties of your RDP entry.
  2. In the VPN/Tunnel/Gateway section, select Devolutions Gateway in the VPN type drop-down list.
    VPN/Tunnel/Gateway – VPN type
    VPN/Tunnel/Gateway – VPN type
  3. In the Connect drop-down list, select Connect if unable to ping/port scan.
    VPN/Tunnel/Gateway – Connect – Connect if unable to ping/port scan
    VPN/Tunnel/Gateway – Connect – Connect if unable to ping/port scan
  4. Under Settings, select the Devolutions Gateway to use for this connection, then click on Check health to make sure the Gateway is functional. Its version must be 2023.1 or later.
    VPN/Tunnel/Gateway – Settings – Check health
    VPN/Tunnel/Gateway – Settings – Check health
  5. In the Session recording section, set the recording Mode.
    Session recording – Mode
    Session recording – Mode
  6. Click Update to save your changes.

Launching the connection

Once all the conditions are met, you can press the Open in web client button to launch the connection from the web client.

Open in web client
Open in web client

If the session recording mode was set to Optional in the entry properties, you will be asked if you want to record this session.

Do you want to record your session?
Do you want to record your session?

A new browser tab should open and your session should start.

RDP session opened in a web client
RDP session opened in a web client

If the connection does not work, check the Requirements again or visit RDP Web client not showing.

Supported features

The tools menu in the RDP web interface contains what is currently supported. Note that the copy/paste feature (including the clipboard) is also supported.

Supported features
Supported features

Icon Option Description
Full screen
Full screen Displays the content of the session, making sure to always occupy the maximum space on the screen.
Fit to screen
Fit to screen (default) Adapts the size to best fit the available space so that the entire session is always visible.
Real size
Real size Conforms to the resolution of the target host.
Windows key
Windows key Sends the signal of the Windows key (however, the key must also work).
Ctrl+Alt+Del
Ctrl + Alt + Del Sends the command to the host system.
Devolutions Forum logo Give us Feedback