# New FSLogix deployment via Parallels RAS

{% hint style="info" %}
**Note:** at the time of writing, Parallels RAS Management Portal can configure FSLogix Profile Containers for RD Session Hosts only. For other host types, please use the desktop-based Parallels RAS Console.
{% endhint %}

FSLogix can be configured on the User profile tab. To reach it follow the steps below.

RD Session Hosts:

1. In Parallels RAS Console, go to **Farm** > **RD Session Hosts > Host pools**.
2. Right-click the Host pool you need and select **Properties**.
3. Select the **User profile** tab.

<figure><img src="/files/KglHVJuEKjgpOVrEhYo5" alt=""><figcaption></figcaption></figure>

1. In Parallels RAS Management Portal, go to **Infrastructure** > **Host pools**.
2. Select the host pool you need.
3. Go to **Properties** > **User Profile**.

<figure><img src="/files/3sd4HETslXQ6HAKoASXN" alt=""><figcaption></figcaption></figure>

VDI:

1. In Parallels RAS Console, go to **Farm** > **VDI** > **Host pools** tab.
2. Right-click the host pool you need and select **Properties**.
3. Select the **User profile** tab.

<figure><img src="/files/TT5zQQJ3dPXdMdk9BaGk" alt=""><figcaption></figcaption></figure>

Azure Virtual Desktop:

1. In Parallels RAS Console, go to **Farm** > **Azure Virtual Desktop** > **Host Pools tab**.
2. Right-click the host pool that you need and select **Properties**.
3. Select the **User Profile** tab.

<figure><img src="/files/AKdWuThOKYlId7ktwCpZ" alt=""><figcaption></figcaption></figure>

The most recent instructions are also available in Parallels RAS Administrator's Guide: <https://download.parallels.com/ras/v19/docs/en\\_US/Parallels-RAS-19-Administrators-Guide.pdf>

FSLogix configuration can either be enforced on an individual server or on multiple servers at once using host pools Group Defaults. For testing purposes, when configuring RDSH, it is recommended to test FSLogix configuration on a single machine before applying the settings to all machines.

To enable FSLogix on a single machine:

1. On the **User Profile** tab, clear the **Inherit default settings** checkbox.
2. In the **Technology** the drop-down menu, select **FSLogix**.

<figure><img src="/files/0OmR5r8oF3KaYK57V9ob" alt=""><figcaption></figcaption></figure>

FSLogix Profile Containers settings are described below.

**Deployment method:** Here you need to select a method that Parallels RAS will use to install FSLogix agent on individual hosts. You can select from one of the following:

**Install manually**: Select this option if you want to install FSLogix agent on every host yourself. If this option is selected, Parallels RAS will not attempt to install FSLogix on a host.

**Install online**: The default method. This option installs FSLogix agent on session hosts from the Internet. Select one of the Parallels supported FSLogix versions from the drop-down list or select **Custom URL** and specify a download URL. Click the **Detect latest** button to automatically obtain a URL of the latest FSLogix version.

**Install from a network share**: Select this option if you have the FSLogix installation files on a network share and specify its location.

**Push from RAS Connection Broker:** This option allows you to upload the FSLogix installation archive to the RAS Connection Broker server. When you enable FSLogix on a session host, it will be push installed on the host from the RAS Connection Broker server.

<figure><img src="/files/ulJy8nY9UNkiNJpZSSv7" alt=""><figcaption></figcaption></figure>

To configure the FSLogix profile container or Office Container disk details, select **User Profile Containers** or **Use Office Containers** and open the **Disks** tab.

<figure><img src="/files/Au1I3IilzPb953rwH1KY" alt=""><figcaption></figcaption></figure>

**Location type**: Select a location type for profile disks (**SMB Location** or **Cloud Cache**).

**Location of profile disks:** Specify one or more locations per FSLogix requirements (<https://docs.microsoft.com/en-us/fslogix/profile-container-configuration-reference>). SMB Location stands for VHDLocations, Cloud Cache – CCDLocations.

{% hint style="info" %}
**Note:** Ensure that the proper storage permissions are set for the location as described in section [**Required storage permissions**](/landing/ras-fslogix-containers-best-practices/v20/prerequisites/required-storage-permissions.md).
{% endhint %}

Example SMB location:

<figure><img src="/files/k42tWaH5nh5qhJtfxrPu" alt=""><figcaption></figcaption></figure>

The value is constructed as:

`<\Location1\Folder1>`

Example Cloud Cache based on an SMB location: :

![caloud cahce](/files/nMN2M4YiLfirzVvhGUWZ)

The value is constructed as:

`type=smb,connectionString=<\Location1\Folder1>`

Example Cloud Cache based on Azure Page Blobs location:

<figure><img src="/files/gjBsVaVQ777KWFLGr5RD" alt=""><figcaption></figcaption></figure>

The value is constructed as:

`type=azure,connectionString=”|fslogix/ConnectionString|”`

Note that ‘fslogix/ConnectionString’ is a reference to a system stored in Windows Credential Manager. That system credential contains the full string pointing to the Azure Page Blob. It is advised to use Windows Credential Manager because otherwise you would expose sensitive Azure credentials to any user who has access to the session host registry. The full string is constructed as:

`"DefaultEndpointsProtocol=https;AccountName=<accountname>;AccountKey=<Accountkey>;EndpointSuffix=core.windows.net"`

This string can be retrieved from your storage account in Azure. Inside the Azure Portal, navigate to the storage account, click **Access Keys**, and copy the contents of **Connection String** as shown below.

<figure><img src="/files/iyq18SLKMmp6PBjgUqnV" alt=""><figcaption></figcaption></figure>

To create, delete, and view system credentials from Windows Credential Manager, use the `frx.exe` command which is a part of FSLogix. For example, to create a new system credential, run the following command:

`C:\Program Files\FSLogix\Apps\frx.exe add-secure-key -key ConnectionString -value` `"DefaultEndpointsProtocol=https;AccountName=<accountname>;AccountKey=<Accountkey>;EndpointSuffix=core.windows.net"` creates a key called `‘ConnectionString’`, matching the previous example. Note that adding `‘fslogix/’` is not required as this is added automatically by frx.exe. For more information on working with Credentials Manager see <https://learn.microsoft.com/en-us/fslogix/configure-cloud-cache-tutorial#protect-azure-key-with-credential-manager>.

**Profile disk format:** Select from VHD or VHDX according to your requirements. VHDX is a newer format and has more features.

**Allocation type:** Select **Dynamic** or **Full**. This setting is used in conjunction with the **Default size** setting (see below) to manage the size of a profile. **Dynamic** causes the profile container to use the minimum space on disk, regardless of the allocated default size. As a user profile is filled with more data, the amount of data on the disk will grow to the size specified in the **Default size** but will never exceed it.

**Default size:** Specifies the size of newly created VHD(X) in megabytes.

<figure><img src="/files/sYIseAOVmIJ5Ld9njZWL" alt=""><figcaption></figcaption></figure>

**Users and Groups:** This tab allows specifying include and exclude user and group lists. By default, “Everyone” is added to the User inclusion list. If you want some user profiles to remain local, you can add those users to the exclude list. Users and groups can exist in both lists, but the exclude list takes priority in this case.

<figure><img src="/files/q2T5Rxu3B4dHmHg9pdRb" alt=""><figcaption></figcaption></figure>

**Folders:** Here you may specify include and exclude lists for folders. Select from common folders or specify your own. Please note that folders must reside in the user profile path.

<figure><img src="/files/KnDLDryTkvONh2f0I1Jj" alt=""><figcaption></figcaption></figure>

* **Advanced:** This tab allows modifying advanced FSLogix Profile Container and Office Container settings. To modify a setting, highlight it and click the Edit button (alternatively, you may use the **Tasks** > **Edit** option from drop down menu in the upper right corner of the tab). Things to consider:
  * By default, all settings are disabled.
  * To enable a setting, select the checkbox in front of its name.
  * A description for each setting is provided in the same window.

**Note:** Please ensure that you’re familiar with the settings before modifying them. For further information regarding FSLogix Profile Containers configurations, see <https://learn.microsoft.com/en-us/fslogix/reference-configuration-settings>.

The **Advanced** tab of Profile Container settings allows you to change settings that are specific to Profile Container.

![](/files/oNw9BvvdRXaQ4kHRw6Hu)

The **Advanced** tab of Office (ODFC) Container settings allows you to change settings that are specific to Office Container.

**Configure general App Services settings**

There are 3 settings that apply to both Profile and the Office Container.

To configure App Services settings:

1. Open the **User profile** tab.
2. Click **Configure general settings** and select the **App Services** tab.

<figure><img src="/files/oM2hLh99hAiQJtRBM4jP" alt=""><figcaption></figcaption></figure>

**Cleanup Invalid Sessions**: In cases where a user's session terminates abruptly, the VHD(X) mounted for the user's profile isn't properly detached and the user's next sign-in may not successfully attach their VHD(X) container. Enable this setting, and FSLogix will attempts to clean up these invalid sessions and allow a successful sign-in.

**Roam Recycle Bin**: When enabled, this setting creates a redirection for the user's specific Recycle Bin into the VHD(X) container. This allows the user to restore items regardless of the machine from where they were deleted.

**VHD Compact Disk**: When enabled, this setting attempts to compact the VHD disk during the sign-out operation. It is designed to automatically reduce the?size of the container file depending on a predefined threshold.


---

# Agent Instructions: 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:

```
GET https://docs.parallels.com/landing/ras-fslogix-containers-best-practices/v20/configuring-fslogix-via-parallels-ras/new-fslogix-deployment-via-parallels-ras.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.