Once Parallels Client for Linux is installed on your computer, you need to configure it, so you can connect to Parallels RAS.
To configure Parallels Client:
In the invitation email that you received from your system administrator, find the Configure section and click the Click Here to auto configure the downloaded client link and follow the instructions.
Once the Parallels Client is configured, it will open and ask you to log into Parallels RAS.
Select the Authentication type from the following:
Credentials. Select this option to connect to Parallels RAS by supplying your credentials, such as your domain user name and password.
Single Sign-On. This option will be included in the list only if the Single Sign-On module is installed during Parallels Client installation. Select this option to use local system credentials to connect to the remote server
Smart card. Select this option to connect to Parallels RAS using a smart card.
Note: Smart card authentication is not supported in Parallels Client for Linux.
Note for Administrators: The allowed authentication type(s) must be specified in the RAS Console in Connection / Authentication.
Depending on the authentication type selected, type your user name and password or insert a smart card into a reader. If using a smart card, enter a PIN when prompted.
Click Connect.
This step may, or may not, appear depending on whether the two-factor authentication using the Google Authenticator app is configured in Parallels RAS by the administrator. If Parallels RAS is configured to use Google Authenticator, you will need to take additional steps. First you need to install the Google Authenticator app on your mobile device. When you click Connect in Parallels Client, you'll see a dialog displaying a barcode (also known as QR code) and a secret key. Scan the code (or enter the secret key) into the Authenticator app. The app will generate a one time password. Click Next in Parallels Client and enter the one-time password in the OTP field. Click Connect. On every subsequent logon, you'll only have to enter the OTP. For step-by-step instructions, see the Using Google Authenticator subsection below. Please note that other TOTPs are also supported (not only Google Authenticator), such as Microsoft Authenticator app.
If the login is successful, the main Parallels Client window opens displaying the published resources that you can use. To open a resource, navigate the published folder tree and double-click a desired resource to open it.
Use the following instructions when you see the multi-factor authentication dialog during the login procedure. The dialog is displayed when your IT administrator configures two-factor authentication using the Google Authenticator app.
Important: To use Google Authenticator, the time on your computer must be synchronized with a global NTP time server, such as time.google.com. Otherwise, Google authentication will fail.
To use Google Authenticator, you need to install the Authenticator app on your iOS or Android device. Simply visit Google Play or App Store and install the app. Once the Authenticator app is installed, you are ready to connect to Parallels RAS using two-factor authentication.
To connect to Parallels RAS:
Opens Parallels Client and log in using your credentials.
The multi-factor authentication dialog opens displaying a barcode (also known as QR code) and a secret key.
Open the Google Authenticator app on your mobile device:
If this is the first time you use it, tap Begin and then tap Scan a barcode.
If you already have another account in Google Authenticator, tap the plus-sign icon and choose Scan a barcode.
Go back to your computer and scan the barcode displayed in the Parallels Client login dialog.
If scanning doesn't work for any reason, go back in the Authenticator app, choose Enter a provided key and then enter the account name and the key displayed in the Parallels Client login dialog.
Tap Add account. This will create an account for your RAS connection and display a one time password.
Go back to Parallels Client, click Next and enter the one-time password in the OTP field.
On every subsequent logon, you only need to type your credentials (or nothing at all if the Save password options was selected) and enter a one-time password obtained from the Google Authenticator app (the app will continually generate a new password). Please note that your IT administrator has an ability to reset user accounts in Google Authenticator. If your account is reset, you'll need to repeat the registration procedure described above.
Your system administrator will send you an invitation email with the instructions on how to install Parallels Client for Linux and configure a Parallels RAS connection in it. The invitation email will contain the following information and action links:
A message from your system administrator.
A link to download Parallels Client for Linux.
A link to automatically configure Parallels Client on your computer.
Parallels RAS connection properties. You can use this information to manually create a Parallels RAS connection. The automatic configuration via the link (see above) is the preferred and the easiest method, but you can use this information to create a connection manually if needed.
To install Parallels Client for Linux using an invitation email:
Make sure you are logged into your computer as a user with administrative privileges.
In the invitation email, click the Linux thumbnail to download Parallels Client for Linux installer.
Download the installer and store it locally.
Installation via GUI is only valid on DEB and RPM versions:
Install the package using the default package installer.
To install Parallels Client, switch to the root user and type the following at the command prompt:
If the installation fails because of missing dependencies, try installing these dependencies using the following command:
Parallels Client for Linux binaries are now installed in the following directory:
Run the following command to launch Parallels Client:
You can also run the following commands to obtain a list of all usage parameters for a Parallels Client session:
To install Parallels Client, switch to the root user and type the following command:
Parallels Client binaries are now installed in the following directory:
Run the following command to launch Parallels Client:
You can also run the following commands to obtain a list of all usage parameters for a Parallels Client session:
To install Parallels Client, switch to the root user and then switch to the root directory:
To install, type the following command:
Parallels Client binaries are now installed in the following directory:
It is recommended that the post-install script is launched in order to register icons, mimetypes, URL schema, and databases configurations. This script is located under: /opt/2X/Client/scripts/install.sh
Run the following command to launch Parallels Client:
You can also run the following commands to obtain a list of all usage parameters for a Parallels Client session:
To unregister the components registered during installation, it is recommended to launch the uninstall script located under: /opt/2X/Client/scripts/uninstall.sh
A separate package to install the SSO module is provided for each version of Linux:
RASClient-sso_x86_64.deb
RASClient-sso_x86_64.tar.bz2
RASClient-sso.x86_64.rpm
Debian SSO packages can be installed and removed using standard installers.
Tar SSO packages can be installed and uninstalled by running /opt/2X/Client/scripts/install_sso.sh or /opt/2X/Client/scripts/uninstall_sso.sh respectively.
Rpm SSO packages need to be configured manually after the installation, as there is no tool available to configure the module correctly. For manual configurations refer to README.SSO that is being shipped inside the /opt/2X/Client/doc/ folder.
In RPM environments (e.g. Fedora), where the pam-auth-update tool is not available, the configuration of the pam module needs to be done manually. There are instructions in the README.SSO file.
To check for the latest available version of Parallels Client for Linux:
In the main Parallels Client for Linux window, click Tools > Options.
In the Options dialog, click the General tab.
Click the Check for updates now button to see if a newer version of Parallels Client for Linux is available.
You can also select the Check for updates on startup option to check for Parallels Client updates every time you open it.
The rest of the options are described in the Configuring Global Options section.
The following table lists the Parallels RAS 19 release history. Parallels RAS documentation is updated for every release. This guide refers to the latest Parallels RAS 19 release from the table below. If you are using a newer Parallels RAS release or version, please download the current version of the guide from https://www.parallels.com/products/ras/resources/.
| Parallels RAS Version | Release | Date |
|---|---|---|
19.0
Initial release
07/27/2022
19.0
Update 1
08/31/2022
19.0
Hotfix 1
09/16/2022
19.0
Hotfix 2
09/30/2022
19.0
Hotfix 3
10/14/2022
19.1
Update 2
11/15/2022
19.2
Update 3
07/06/2023
19.3
Update 1
11/06/2023
19.4
Update 2
06/08/2024
Supported Linux distributions (x64 versions only):
Ubuntu 20.04 LTS, 22.04 LTS, 24.04 LTS
Debian 11 (Bullseye), Debian 12 (Bookworm)
Fedora 37, 38
Linux Mint 20, 21
IGEL 11, 12
ThinOS/Dell Wyse Thin Clients 2303, 2306, 2308
Parallels Client supports all default window managers of the distributions listed above. If you use a different window manager, your experience may vary from the intended.
Parallels® Client for Linux is an app that allows you to connect to Parallels Parallels RAS from a Linux computer and run remote applications and desktops.