> ## 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.

# Install Gorelo Connect (remote control)

> Install Gorelo Connect on Windows or macOS technician workstations to start remote control sessions from the Asset Detail page using one-click connections.

## Requirements

To successfully install Gorelo Connect on your machine, you need:

1. An active Gorelo subscription.
2. Gorelo Connect installed on the assets you want to monitor.

With these requirements in place, you can install Gorelo Connect on your machine and start monitoring your assets remotely.

## Install Gorelo Connect (technician side)

<Tabs>
  <Tab title="Windows">
    1. On an asset with the Gorelo Connect plugin, click the ‘Connect’ button.

    <Frame>
      <img src="https://mintcdn.com/gorelo/KSUOeY5OCdJmZr31/images/image-79.png?fit=max&auto=format&n=KSUOeY5OCdJmZr31&q=85&s=8756709a3732e313c592b56eeca50746" alt="Image" width="412" height="303" data-path="images/image-79.png" />
    </Frame>

    2. You will see a small banner appear, click ‘Download’
           <Frame>
             <img src="https://mintcdn.com/gorelo/KSUOeY5OCdJmZr31/images/image-78.png?fit=max&auto=format&n=KSUOeY5OCdJmZr31&q=85&s=6f8a938be3f7553970590b0b3acb6bac" alt="Image" width="572" height="49" data-path="images/image-78.png" />
           </Frame>
    3. Install GoreloLauncher.exe (there will be two UAC prompts — one for Gorelo Launcher and one for Gorelo Connect)
    4. Click the ‘Connect’ button again
    5. Always allow the protocol handler to open gorelolauncher links
           <Frame>
             <img src="https://mintcdn.com/gorelo/KSUOeY5OCdJmZr31/images/image-80.png?fit=max&auto=format&n=KSUOeY5OCdJmZr31&q=85&s=cbd8b705a28c76b7fd2e0de949c4a4e8" alt="Image" width="415" height="194" data-path="images/image-80.png" />
           </Frame>
    6. You’ll then see the Launcher appear — followed quickly by the Gorelo Connect window
           <Frame>
             <img src="https://mintcdn.com/gorelo/eK-NlDv-DeG3Jk2m/images/gorelo-connect-launcher.png?fit=max&auto=format&n=eK-NlDv-DeG3Jk2m&q=85&s=8af1c786bb45e11de995f4b04fce3c3d" alt="Image" width="571" height="193" data-path="images/gorelo-connect-launcher.png" />
           </Frame>
           <Frame>
             <img src="https://mintcdn.com/gorelo/KSUOeY5OCdJmZr31/images/image-81.png?fit=max&auto=format&n=KSUOeY5OCdJmZr31&q=85&s=f4095e6b58f19a6b18af5dc2cdb826ed" alt="Image" width="939" height="593" data-path="images/image-81.png" />
           </Frame>

    ## Reinstall Gorelo Connect on an asset

    1. On an asset with the Gorelo Connect plugin, click the Policy section
           <Frame>
             <img src="https://mintcdn.com/gorelo/KSUOeY5OCdJmZr31/images/image-83.png?fit=max&auto=format&n=KSUOeY5OCdJmZr31&q=85&s=1810fcbd668d12d70189e2cbbe62aa66" alt="Image" width="314" height="216" data-path="images/image-83.png" />
           </Frame>
    2. On the Gorelo Connect plugin, click the ‘heart’ icon to check health
           <Frame>
             <img src="https://mintcdn.com/gorelo/KSUOeY5OCdJmZr31/images/image-82.png?fit=max&auto=format&n=KSUOeY5OCdJmZr31&q=85&s=ab152e7470637c7ae1c53f6d238bd578" alt="Image" width="953" height="131" data-path="images/image-82.png" />
           </Frame>
    3. Then click the reinstall button when it appears.

    ## Manually add Gorelo Connect to a policy

    1. Navigate to [**<u>Policies</u>**](https://app.gorelo.io/Asset/policy-management) from the menu
    2. Select an existing Policy
    3. Hover over the ‘Add’ button up the top-right and then select ‘Plugin’
    4. Select ‘Gorelo Connect’ from the list
    5. Click ‘**Save**’
    6. **Distribute** the policy

    <Tip>
      **Dedicated IP addresses**

      Seattle: `172.179.240.232` [connect.usw.gorelo.tech](http://connect.usw.gorelo.tech)

      Sydney: `20.5.234.185` [connect.aue.gorelo.tech](http://connect.aue.gorelo.tech)

      \
      Add both of these to your [**Tooling Allowlist**](https://support.huntress.io/hc/en-us/articles/26620768607891-Host-Isolation-IP-Allowlist) in Huntress for remote access during host isolation.
    </Tip>

    ## Choose default remote control tool

    Gorelo allows you to choose between the built-in tool or ScreenConnect as your default — all of the primary remote control buttons will then be bound to this selection.

    1. Navigate to Settings → Assets → [**Settings**](https://app.gorelo.io/admin/admin-settings#asset#customassettype)
    2. Toggle between Gorelo Connect or Screenconnect
    3. Click ‘**Update**’

    <Tip>
      Screenconnect requires a third-party subscription and is not included with Gorelo.
    </Tip>
  </Tab>

  <Tab title="macOS">
    ## Automatic install

    Gorelo Connect is automatically installed on new assets when the RMM agent is first installed.

    ## Manual install

    For existing macOS assets, Gorelo Connect can be manually enabled/disabled via the 3-dot menu. This can be used to manually install Gorelo Connect or to go through a reinstall process.

    <Frame>
      <img src="https://mintcdn.com/gorelo/FRk8oIZJDzG89xKk/images/goreloconnect-macos-manualinstall.gif?s=fde49fd313850517a3d23caff759472b" alt="Goreloconnect Macos Manualinstall" width="341" height="340" data-path="images/goreloconnect-macos-manualinstall.gif" />
    </Frame>

    ## Grant permissions

    On the first install (automatic or manual), you will be prompted to grant permission for Gorelo Connect in three areas:

    * Full Disk Access
    * Accessibility
    * Screen & System Audio Recording

    Select ‘Open System Settings’ on each popup and toggle on access for GoreloConnect — ‘Quit & Reopen’ if requested.

    <Frame>
      <img src="https://mintcdn.com/gorelo/FRk8oIZJDzG89xKk/images/goreloconnect-macos-permissions.gif?s=6977aa74817cccea34e218ba66d87abb" alt="Goreloconnect Macos Permissions" width="1019" height="596" data-path="images/goreloconnect-macos-permissions.gif" />
    </Frame>

    ## Troubleshooting

    | **Issue**                                                         | **Fix**                                                                |
    | :---------------------------------------------------------------- | :--------------------------------------------------------------------- |
    | Remote keyboard/mouse not working                                 | Confirm **Accessibility** permission is enabled                        |
    | File transfer fails or prompting for individual folder permission | Confirm **Full Disk Access** permission is enabled                     |
    | Black screen or ‘Waiting for image’                               | Confirm **Screen Recording** permission is enabled                     |
    | No connection after macOS restart                                 | End user needs to log in first to decrypt the startup disk (FileVault) |
  </Tab>
</Tabs>