> ## Documentation Index
> Fetch the complete documentation index at: https://help.gorelo.io/llms.txt
> Use this file to discover all available pages before exploring further.

# ScreenConnect integration

> Integrate ScreenConnect with Gorelo for one-click remote desktop sessions and agent installation, with Instance ID, API path, and credential configuration.

Gorelo integrates with ScreenConnect for one-click Remote Desktop connections and agent installation.

<Steps>
  <Step title="Integrate with ScreenConnect.">
    1. Navigate to **Settings** > **[Integrations](https://app.gorelo.io/Admin/admin-settings#integrations).**
    2. Click the ⚙️**cog** icon to configure **ScreenConnect.**

    <Frame>
      <img src="https://mintcdn.com/gorelo/q7dFrHu-syAO8TzZ/images/image-161.png?fit=max&auto=format&n=q7dFrHu-syAO8TzZ&q=85&s=e2e39041ee36d5dc983539e5cc6cd9bb" alt="Image" width="814" height="396" data-path="images/image-161.png" />
    </Frame>

    3. Fill in the required fields:
       * **Instance ID**
       1. Access one of your endpoints that already has your ScreenConnect Client installed.
       2. Navigate to **Services**.
       3. Copy the value of the ScreenConnect Client Service in parentheses:
           <Frame>
             <img src="https://mintcdn.com/gorelo/q7dFrHu-syAO8TzZ/images/image-162.png?fit=max&auto=format&n=q7dFrHu-syAO8TzZ&q=85&s=4f29b9ca666c38f96a2da823332577a9" alt="Image" width="1087" height="373" data-path="images/image-162.png" />
           </Frame>
       * **MSI URL**
       1. Log in to your ScreenConnect tenant.
       2. Click **Access.**
       3. Click **Build.**
       4. Change type to **Windows (MSI).**
       5. Click **copy URL.**
           <Frame>
             <img src="https://mintcdn.com/gorelo/q7dFrHu-syAO8TzZ/images/image-163.png?fit=max&auto=format&n=q7dFrHu-syAO8TzZ&q=85&s=a91e07066acc6d5d6dbadb01af7f26c5" alt="Image" width="1320" height="1063" data-path="images/image-163.png" />
           </Frame>
    4. Click **Connect.**

    <Tip>
      Gorelo automatically inserts the client name into the ScreenConnect company field on install. See Step 3 for additional configuration.
    </Tip>
  </Step>

  <Step title="Distribute the ScreenConnect Plugin.">
    1. Navigate to [Policies](https://app.gorelo.io/Asset/policy-management) in the main menu.
    2. Add the ScreenConnect plugin to an existing policy or create a new one.
    3. Click **Distribute.**

    <Tip>
      **Tips!**

      See the [Policies](/how-policies-work) guide for additional information.
    </Tip>
  </Step>

  <Step title="Optional: Create a sub-session group in ScreenConnect for each client.">
    1. Log in to your ScreenConnect tenant.
    2. Navigate to **Access**.
    3. Click the **3-dot menu** on the **All Machines** session group and click **Edit.**
    4. Enter `CustomProperty1` in the **Subgroup Expressions** field.
    5. Click **Save.**

    <Frame>
      <img src="https://mintcdn.com/gorelo/q7dFrHu-syAO8TzZ/images/image-164.png?fit=max&auto=format&n=q7dFrHu-syAO8TzZ&q=85&s=21d1aa8832587625f334f7d82f26acc6" alt="Image" width="655" height="405" data-path="images/image-164.png" />
    </Frame>
  </Step>
</Steps>

## Troubleshooting

### ScreenConnect is not connecting on a specific asset

If ScreenConnect doesn't show a connection on a specific asset, reinstall it by following these steps:

1. Navigate to the details page of the specific asset.
2. Click the **Policy** tab down the bottom-left:
   <Frame>
     <img src="https://mintcdn.com/gorelo/k9Vf68jFwh3yoHvE/images/image-167.png?fit=max&auto=format&n=k9Vf68jFwh3yoHvE&q=85&s=296109407a2ba4eac86c54a25e457f84" alt="Image" width="1410" height="657" data-path="images/image-167.png" />
   </Frame>
3. Click the heart icon on the ScreenConnect plugin.
4. Click the ScreenConnect icon to reinstall.