Open in the explorer

Configure Client failover proxy settings

Type
User
GPO path
User 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_AltProxyLockdown_1

Explanation

Use this policy to configure alternative network proxies that the client can use if the primary network proxy fails to connect to a remote application or desktop.

When this policy is not configured, the client will use its own settings to decide whether to connect through a proxy server.

When this policy is enabled, the client will attempt a connection using an alternative proxy if connection to a primary proxy fails. The failover proxy settings operate in an identical fashion to the primary proxy settings.

If both the primary and alternative proxy fail to service the connection, selecting the "Failover to direct" check box instructs the client to attempt a final direct connection with no proxies.

Troubleshooting:
Some proxy failures can make the client appear to hang on connection. This is usually due to the proxy server reattempting the connection itself, or having a long time-out period. Depending on the network topology, it may be preferable to configure the Web Interface server to identify the currently functioning proxy, or alter the proxy server time-out settings.

Registry

HKEY_CURRENT_USER\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_AltProxyLockdown_1
$k = 'HKCU:\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 }
# Proxy types
# Possible options:
#   Auto = Auto
#   None = None
#   SOCKS = SOCKS
#   SOCKSv4 = SOCKSv4
#   SOCKSv5 = SOCKSv5
#   Secure = Secure
#   Script = Script
Set-ItemProperty -Path $k -Name 'AltProxyType' -Value 'Auto' -Type String
# Proxy host names
Set-ItemProperty -Path $k -Name 'AltProxyHost' -Value '<value>' -Type String
# Proxy ports
Set-ItemProperty -Path $k -Name 'AltProxyPort' -Value '<value>' -Type String
# Proxy script URLs
Set-ItemProperty -Path $k -Name 'AltProxyAutoConfigUrl' -Value '<value>' -Type String
# Bypass server list
Set-ItemProperty -Path $k -Name 'AltProxyBypassList' -Value '<value>' -Type String
# Failover to direct
Set-ItemProperty -Path $k -Name 'ProxyFallback' -Value '<value>' -Type String

Disable

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

Revert to "Not configured"

# Revert to "Not configured": receiver/Policy_AltProxyLockdown_1
$k = 'HKCU:\Software\Policies\Citrix\ICA Client\Engine\Lockdown Profiles\All Regions\Lockdown\Network\Proxy'
Remove-ItemProperty -Path $k -Name 'AltProxyType' -ErrorAction SilentlyContinue
Remove-ItemProperty -Path $k -Name 'AltProxyHost' -ErrorAction SilentlyContinue
Remove-ItemProperty -Path $k -Name 'AltProxyPort' -ErrorAction SilentlyContinue
Remove-ItemProperty -Path $k -Name 'AltProxyAutoConfigUrl' -ErrorAction SilentlyContinue
Remove-ItemProperty -Path $k -Name 'AltProxyBypassList' -ErrorAction SilentlyContinue
Remove-ItemProperty -Path $k -Name 'ProxyFallback' -ErrorAction SilentlyContinue

Options (6)

LabelControlRegistry valueREG typeConstraints / details
Proxy typesPart_AltProxy_ProxyTypeLockdownDrop-down listenumAltProxyTypeREG_SZ
LabelValue
AutoREG_SZ = Auto
NoneREG_SZ = None
SOCKSREG_SZ = SOCKS
SOCKSv4REG_SZ = SOCKSv4
SOCKSv5REG_SZ = SOCKSv5
SecureREG_SZ = Secure
ScriptREG_SZ = Script
Proxy host namesPart_AltProxy_ProxyHostLockdownText boxtextAltProxyHostREG_SZ
Proxy portsPart_AltProxy_ProxyPortLockdownText boxtextAltProxyPortREG_SZ
Proxy script URLsPart_AltProxy_ProxyAutoConfigUrlLockdownText boxtextAltProxyAutoConfigUrlREG_SZ
Bypass server listPart_AltProxy_ProxyBypassListLockdownText boxtextAltProxyBypassListREG_SZ
Failover to directPart_AltProxy_ProxyFallbackLockdownText boxtextProxyFallbackREG_SZ

Application

Citrix Workspace app (Citrix) — October 2026 templates

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