> For the complete documentation index, see [llms.txt](https://docs.parallels.com/landing/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.parallels.com/landing/ras-linux-client-guide/getting-started/configuring-parallels-client-for-linux.md).

# Configuring Parallels Client for Linux

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:

1. 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.
2. Once the Parallels Client is configured, it will open and ask you to log into Parallels RAS.
3. 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.

{% hint style="warning" %}
**Note:** Smart card authentication is not supported in Parallels Client for Linux.
{% endhint %}

{% hint style="info" %}
**Note for Administrators:** The allowed authentication type(s) must be specified in the RAS Console in **Connection** / **Authentication**.
{% endhint %}

4. 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.
5. Click **Connect**.
6. The next step may or may not appear depending on whether multifactor authentication (MFA) is configured in Parallels RAS by the administrator. If configured, you need to enter a one-time password (OTP). Parallels RAS supports various MFA providers (Google Authenticator, RADIUS, Deepnet Security, SafeNet, etc.).

   To gain a general understanding of what the connection process may look like if MFA is configured, please see the **Authentication Using Google Authenticator**.

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.

### **Using Google Authenticator**

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.

{% hint style="warning" %}
**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.
{% endhint %}

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:

1. Open Parallels Client and log in using your credentials.
2. The multi-factor authentication dialog opens, displaying a barcode (also known as a QR code) and a secret key.
3. 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**.
4. 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 to the Authenticator app, choose **Enter a provided key,** and then enter the account name and the key displayed in the Parallels Client login dialog.
5. Tap **Add account**. This will create an account for your RAS connection and display a one-time password.
6. 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** option 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 the ability to reset user accounts in Google Authenticator. If your account is reset, you'll need to repeat the registration procedure described above.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.parallels.com/landing/ras-linux-client-guide/getting-started/configuring-parallels-client-for-linux.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
