Parallels Client for Linux
ProductsSupportPartnersDocumentation
  • Getting Started
    • Parallels RAS 19 release history
    • System Requirements
    • Installing Parallels Client for Linux
    • Configuring Parallels Client for Linux
    • Checking for Updates
  • Using Parallels Client for Linux
    • Adding a New Connection
    • Configuring a RAS Connection
      • Connection
      • Display
      • Printing
      • Local Resources
      • Experience
      • Network
      • Authentication
      • Advanced Settings
    • Configuring an RDP Connection
      • Connection
      • Display
      • Local Resources
      • Programs
      • Experience
      • Network
      • Authentication
      • Advanced Settings
  • Configuring Global Options
  • Using a RAS Connection
  • Using an RDP Connection
  • Exporting and Importing Parallels Client Settings
  • Parallels Client Network Configuration File
    • Format
    • Parameters
      • KA_ENABLE
      • KA_MAXIDLE
      • KA_COUNT
      • KA_INTERVAL
      • USER_TIMEOUT
  • Parallels Client Command Line Interface
    • General Options
    • RDP Options
    • Device Options
    • Other Options
    • Examples
Powered by GitBook

Social media

  • Facebook
  • Twitter
  • LinkedIn
  • YouTube

Other Resources

  • Feedback

© 2025 Parallels International GmbH. All rights reserved.

On this page
  • Installation Procedure — GUI
  • Installation Procedures — CLI
  • DEB Version
  • RPM Version
  • .TAR.BZ2 Version
  • The SSO (Single Sign On) Module Installation Procedures
  • Known issues and limitations

Was this helpful?

Export as PDF
  1. Getting Started

Installing Parallels Client for Linux

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:

  1. Make sure you are logged into your computer as a user with administrative privileges.

  2. In the invitation email, click the Linux thumbnail to download Parallels Client for Linux installer.

  3. Download the installer and store it locally.

Installation Procedure — GUI

Installation via GUI is only valid on DEB and RPM versions:

  • Install the package using the default package installer.

Installation Procedures — CLI

DEB Version

To install Parallels Client, switch to the root user and type the following at the command prompt:

dpkg -i parallelsclient.deb

If the installation fails because of missing dependencies, try installing these dependencies using the following command:

apt-get -f install

Parallels Client for Linux binaries are now installed in the following directory:

/opt/2X/Client/bin

Run the following command to launch Parallels Client:

/opt/2X/Client/bin/2XClient

You can also run the following commands to obtain a list of all usage parameters for a Parallels Client session:

cd /opt/2X/Client/bin
/appserverclient -?

RPM Version

To install Parallels Client, switch to the root user and type the following command:

rpm –ivh 2XClient.i386.rpm

Parallels Client binaries are now installed in the following directory:

/opt/2X/Client/bin

Run the following command to launch Parallels Client:

/opt/2X/Client/bin/2XClient

You can also run the following commands to obtain a list of all usage parameters for a Parallels Client session:

cd /opt/2X/Client/bin
/appserverclient -?

.TAR.BZ2 Version

To install Parallels Client, switch to the root user and then switch to the root directory:

cd /

To install, type the following command:

tar jxvf 2XClient.tar.bz2

Parallels Client binaries are now installed in the following directory:

/opt/2X/Client/bin

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:

/opt/2X/Client/bin/2XClient

You can also run the following commands to obtain a list of all usage parameters for a Parallels Client session:

cd /opt/2X/Client/bin
/appserverclient -?

To unregister the components registered during installation, it is recommended to launch the uninstall script located under: /opt/2X/Client/scripts/uninstall.sh

The SSO (Single Sign On) Module Installation Procedures

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.

Known issues and limitations

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.

PreviousSystem RequirementsNextConfiguring Parallels Client for Linux

Last updated 1 year ago

Was this helpful?