# Guacamole Pre-Requisites

#### Port Requirements:

<table><thead><tr><th width="200">Connection Type</th><th width="166">Provider/OS</th><th width="244">Port</th><th>Target</th></tr></thead><tbody><tr><td>IP Connect</td><td>Linux</td><td>22</td><td>VM</td></tr><tr><td>IP Connect</td><td>Windows</td><td>3389</td><td>VM</td></tr><tr><td>Console Connect</td><td>VCenter (Version lower then 7)</td><td>1000-9999, 50000-50999</td><td>Hosts</td></tr><tr><td>Console Connect</td><td>SPF</td><td>2179</td><td>Hosts</td></tr></tbody></table>

####

#### Guacamole pre-requisites for Virtual Machine / VM template  &#x20;

When setting up a base template in vCenter or VMM, please make sure to apply the settings below. This is mandatory to launch a VM through guacamole using Hybr.&#x20;

**IP Connect:**&#x20;

1. &#x20;**Linux:**
   1. &#x20;OpenSSH-server needs to be installed&#x20;
   2. &#x20;The virtual machine should have network attached&#x20;
   3. &#x20;Port 22 should be allowed in the firewall (SSH)&#x20;
   4. &#x20;The virtual machine should be accessible from the guacamole servers&#x20;
2. &#x20;**Windows:**&#x20;
   1. &#x20;RDP is enabled in the virtual machine&#x20;
   2. &#x20;RDP Port 3389 should be enabled
   3. &#x20;The Virtual Machine should be accessible from the guacamole servers
   4. &#x20;WDDM should be disabled
      1. &#x20;Windows 10 template requirements for Apache Guacamole
         1. Disable WDDM: <http://apache-guacamole-general-user-mailing-list.2363388.n4.nabble.com/Error-114-in-gaucd-td7242.html#a7267>
         2. Gpedit.msc -> Local Computer Policy -> Computer Configuration -> Administrative Templates -> Windows Components -> Remote Desktop Services -> Remote Session Environments -> Disable Use WDDM Graphics

**Console Connect:**

1. &#x20;**vCenter (Version lower than 7):**
   1. &#x20;Console Port Ranges for each host should be enabled in network
   2. &#x20;VNC protocol should be enabled for each host&#x20;
   3. &#x20;Host machines should be accessible from the guacamole server
   4. &#x20;Note: For existing workloads that were onboarded (Sync) to Hybr require a manual Sync operation in the Hybr admin portal.
      1. &#x20;For the Synced VMs after the port assignment, needs to restart the VM in order to console connect it.
2. &#x20;**SPF:**
   1. &#x20;RDP should be enabled in all the hosts of the VMM
   2. &#x20;Console port 2179 (default) should be allowed in firewall
   3. &#x20;Host machines should be accessible from the guacamole servers
   4. &#x20;Host credentials need to be entered in Hybr. **The username should be the represented in @ notation for domain users or local machine user can be used. (*****user01\@domain or user01 instead of domain\user01*****)**

#### Reason: &#x20;

Without this setting on a VM template / Virtual machine, user will face error while connecting to a VM through guacamole using Hybr.

&#x20; Error: (You have been disconnected issue) segfault 0


---

# 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.cloudassert.com/hybr/installation/hybr-pre-requisites/services/remote-connect/guacamole-troubleshooting.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.