Open in the explorer

Configure SOCKS proxy settings

Type
Computer
GPO path
Computer Configuration › Policies › Administrative Templates › Citrix Components › Citrix Workspace › Network routing › Proxy
Supported on
All Citrix Workspace supported platforms
ADMX file
receiver.admx
Internal name
receiver/Policy_ProxySocks

Explanation

Use this policy to configure the use of additional SOCKS proxies that are required for some advanced network topologies.

When enabled, the client will examine the "SOCKS protocol version" setting. If connection via SOCKS is not disabled, the client will attempt to connect using the SOCKS proxy specified by the "Proxy host names" and "Proxy ports" settings.

The client supports connections using either SOCKS v4 or SOCKS v5 proxy servers. Alternatively, it can attempt to automatically detect the version being used by the proxy server.

Troubleshooting:
The SOCKS proxy settings are designed for traversing a proxy in addition to the primary or alternative proxy server. When traversing only a single proxy, these SOCKS proxy settings should be disabled.

Registry

HKEY_LOCAL_MACHINE\Software\Policies\Citrix\ICA Client\Engine\Lockdown Profiles\All Regions\Lockdown\Network\Proxy
Value name
not defined in the ADMX

Enable / disable values: not defined in the ADMX (see the options below).

PowerShell

PowerShell commands that write to the registry what the policy would write. Values in angle brackets (<…>) must be replaced.

Writing directly to the registry bypasses Group Policy: if a GPO manages this value, it will be rewritten at the next gpupdate; otherwise the value stays in place (the "tattooing" effect). Prefer a GPO or, locally, LGPO.exe. Run PowerShell as administrator for HKLM. Some policies need a restart or gpupdate /force.

Enable

# Enable: receiver/Policy_ProxySocks
$k = 'HKLM:\Software\Policies\Citrix\ICA Client\Engine\Lockdown Profiles\All Regions\Lockdown\Network\Proxy'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
# SOCKS protocol version
# Possible options:
#   Disabled = -1,default
#   Detect version = 0,4,5
#   SOCKS v4 = 4
#   SOCKS v5 = 5
Set-ItemProperty -Path $k -Name 'ICASOCKSProtocolVersion' -Value '0,4,5' -Type String
# Proxy host names
Set-ItemProperty -Path $k -Name 'ICASOCKSProxyHost' -Value '<value>' -Type String
# Proxy ports
Set-ItemProperty -Path $k -Name 'ICASOCKSProxyPortNumber' -Value '<value>' -Type String

Disable

# Disable: receiver/Policy_ProxySocks
# No value is written in the "Disabled" state (nothing defined in the ADMX)

Revert to "Not configured"

# Revert to "Not configured": receiver/Policy_ProxySocks
$k = 'HKLM:\Software\Policies\Citrix\ICA Client\Engine\Lockdown Profiles\All Regions\Lockdown\Network\Proxy'
Remove-ItemProperty -Path $k -Name 'ICASOCKSProtocolVersion' -ErrorAction SilentlyContinue
Remove-ItemProperty -Path $k -Name 'ICASOCKSProxyHost' -ErrorAction SilentlyContinue
Remove-ItemProperty -Path $k -Name 'ICASOCKSProxyPortNumber' -ErrorAction SilentlyContinue

Options (3)

LabelControlRegistry valueREG typeConstraints / details
SOCKS protocol versionPart_ProxySocks_VersionDrop-down listenumICASOCKSProtocolVersionREG_SZ
Default choice (UI): #1
LabelValue
DisabledREG_SZ = -1,default
Detect versionREG_SZ = 0,4,5
SOCKS v4REG_SZ = 4
SOCKS v5REG_SZ = 5
Proxy host namesPart_ProxySocks_ProxyHostLockdownText boxtextICASOCKSProxyHostREG_SZ
Proxy portsPart_ProxySOCKS_ProxyPortLockdownText boxtextICASOCKSProxyPortNumberREG_SZ

Application

Citrix Workspace app (Citrix) — October 2026 templates

October 2026 templates from pl4nty/web-admx-tool.