Using the Parallels HTML5 Client

594 users found this article helpful

The HTML5 Client is a RAS client application that runs inside a web browser. End users can use Parallels HTML5 Client to view, launch, and work with remote applications and desktop in a web browser. The Parallels HTML5 Client does not require end users to install additional software on their computers, therefore it is not platform-specific.

The only requirement to use Parallels HTML5 Client is an HTML5-enabled web browser that must be installed on a client computer.

Open Parallels HTML5 Client

To open Parallels HTML5 Client in a web browser, enter one of the following in a web browser, depending on your setup:


When you open the URL in a web browser, the login page is displayed.

Note: By default, when a user opens HTML5 Client in a web browser for the first time, the cookie consent message is displayed at the top of the page in accordance with the GDPR regulation. To read the Parallels cookie policy, the user clicks the provided link. To agree with the policy, the user clicks Got it to close the message and continue. The RAS administrator can disable the cooke consent message in the Theme settings in RAS Console.

To log in to Parallels RAS, specify your user name in the UPN format ( and password and click Log in.

Note: If Parallels RAS is configured to use Google Authenticator as a second-level authentication provider, an additional dialog opens where the user can either scan a QR code or use a secret key to generate a one-time password (OTP). For details, please see Using Google Authenticator.

Once the user is logged in, one of the scenarios described below takes place depending on how the HTML5 Client is configured on the server-side. 

Launching apps in Parallels Client and fallback to HTML5

With this option configured on the server side, you will see a dialog box in the web browser with the following options:

Note: If you don't have administrative permissions on this computer, a dialog will open saying so. The dialog has two buttons: Install Full Client and Install Basic Client. If you know credentials of an administrative account on this computer, click Install Full Client and enter the credentials when asked. The installation will continue using these credentials and the full version of Parallels Client will be installed. If you don't know the credentials, click Install Basic Client. The basic version of Parallels Client will still work but some of the functionality will be missing.

After the installation, you should see Parallels HTML5 Client displaying published resources that you can use. Please also note a link in the lower-left corner of the screen displaying the Parallels Client version and build number.

You can now run remote applications and desktop in Parallels Client or in a browser (HTML5). The default method for running applications and desktops is Parallels Client. To run a remote application or desktop in a browser, right-click it (or tap and hold on a mobile device) and then choose Parallels HTML5 Client.


Launch apps in Parallels Client

When this option is configured on the server-side, you will see a dialog box prompting you to install Parallels Client. Click the link provided to open the Parallels Client download and installation page and follow the instructions. After you install Parallels Client, the main Parallels HTML5 Client screen opens displaying published resources that you can use. If you now double-click or tap a resource, it will be launched in Parallels Client.

Launch apps in browser only (HTML5 only)

With this option configured, the main Parallels HTML5 Client screen opens with no additional prompts. Remote applications and desktops will be launched in the web browser.

Main Menu Options

To open the Parallels HTML5 Client main menu, click or tap the "person" icon in the upper-right. You can select from the menu options described below.


Allows you to configure the following settings:

Note: Audio input is supported in Chrome, Firefox, Edge and Safari 11. If your browser doesn't support audio input, this setting will be disabled and you will see a text message instead

Change Password

Allows the user to remotely change their domain password. When the password is being changed, the password requirements are displayed on the screen, so the user can follow them for the new password to be accepted. This option can be disabled through Client Policies (Control settings > Password > Prohibit changing password).

Detect Client

Determines if Parallels Client is installed on the local computer. If Parallels Client is not installed, gives user an option to install it or skip the automatic Parallels Client detection on subsequent logons.

Download Client

Opens a web page with instructions on how to download and install Parallels Client.


Ends user session with Parallels RAS and logs the user out.


Launching Remote Applications and Desktops

To launch a remote application or desktop in Parallels HTML5 Client, do one of the following:

Please note that to open a resource in Parallels Client from the HTML5 page, a URL with a custom scheme is used. When you double-click on a resource on the HTML5 page, the URL is executed and is then passed to Parallels Client which uses the instructions that it contains to open the resource. For more information see RAS HTML5 Gateway API and Parallels Client URL Scheme (p. 397).

Using drag and drop functionality

Parallels HTML5 Client supports drag and drop functionality when running remote applications and desktops.

Note: The Allow file transfer command option must be enabled on the Gateway for the drag and drop functionality to work.

Here's how to use drag and drop when working with a remote application:

  1. Select a file on your local computer.
  2. Drag and drop the selected file to an app. The 'Save as' window will pop up.
  3. Enter a name for the file and save it. The file will be saved on the server hosting the app.

You can also drag and drop files between two remote apps running on different hosts.

Here's how to use drag and drop with a remote desktop:

  1. Select a file on your local computer.
  2. Drag and drop the selected file to a remote desktop. The 'save as' window will pop up.
  3. Enter a name for the file and save it. The file will be saved on the desktop on the server that hosts it.

Other useful features

Other useful functionality on the main Parallels HTML5 Client screen includes the following:


You have already left your feedback.