diff --git a/README.md b/README.md
index 16cc9fa..104a4d3 100644
--- a/README.md
+++ b/README.md
@@ -53,6 +53,7 @@ code (even log message strings are absent from the binary) and without symbols.
   - [Frontend Installation](#-frontend-installation)
   - [Backend Installation](#-backend-installation)
 - [Usage](#-usage)
+- [Troubleshooting](#-troubleshooting)
 - [Contributing](#-contributing)
 - [License](#-license)
 
@@ -338,6 +339,25 @@ such as `nc`, and use the available command:
 - `cat xxxx`, `push xxxx`, `put xxxx`, `send xxxx`, `upload xxxx`: sends the
   content of the file at the provided path.
 
+## Troubleshooting
+
+### Citrix
+
+If you get an error like `failed to open channel handle: virtual channel open failed (last_error = 5)` that's means there are some restrictions on citrix host virtual channels (default behavior in last Citrix version).
+To fix this, if you have (local) administrator privileges, you can disable Citrix restrictions on virtual channels (which is not recommended):
+
+```powershell
+reg add HKLM\SOFTWARE\WOW6432Node\Policies\Citrix\VCPolicies /v VirtualChannelWhiteList /t REG_MULTI_SZ /d =disabled=
+```
+
+Or you can whitelist `SOXY` like this if you have (local) administrator privileges:
+
+```powershell
+reg add HKLM\SOFTWARE\WOW6432Node\Policies\Citrix\VCPolicies /v VirtualChannelWhiteList /t REG_MULTI_SZ /d SOXY,C:\Users\<USER>\<PATH_TO_SOXY_EXE>
+```
+
+Note that in both case, you have to reboot Citrix host after.
+
 ## 🚧 Contributing
 
 Adding a new service (let's called it `ping`) in soxy requires to develop a new