Open in the explorer

SOCKS Host

Type
Computer and user
GPO path
Computer Configuration › Policies › Administrative Templates › Mozilla › Firefox › Proxy Settings User Configuration › Policies › Administrative Templates › Mozilla › Firefox › Proxy Settings
Supported on
Firefox 60 or later, Firefox 60 ESR or later
ADMX file
firefox.admx
Internal name
firefox/Proxy_SOCKSProxy

Explanation

If this policy is enabled, you can set the SOCKS Host and version used when manual proxy configuration is specified.

If this policy is disabled or not configured, Firefox does not use a SOCKS Host.

Registry

HKEY_LOCAL_MACHINE\Software\Policies\Mozilla\Firefox\Proxy
HKEY_CURRENT_USER\Software\Policies\Mozilla\Firefox\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.

Computer (HKLM)

Enable

# Enable: firefox/Proxy_SOCKSProxy
$k = 'HKLM:\Software\Policies\Mozilla\Firefox\Proxy'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
# Host including port
Set-ItemProperty -Path $k -Name 'SOCKSProxy' -Value '<value>' -Type String
#
# Possible options:
#   SOCKS v4 = 4
#   SOCKS v5 = 5
Set-ItemProperty -Path $k -Name 'SOCKSVersion' -Value 4 -Type DWord

Disable

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

Revert to "Not configured"

# Revert to "Not configured": firefox/Proxy_SOCKSProxy
$k = 'HKLM:\Software\Policies\Mozilla\Firefox\Proxy'
Remove-ItemProperty -Path $k -Name 'SOCKSProxy' -ErrorAction SilentlyContinue
Remove-ItemProperty -Path $k -Name 'SOCKSVersion' -ErrorAction SilentlyContinue

User (HKCU)

Enable

Disable

Revert to "Not configured"

Options (2)

LabelControlRegistry valueREG typeConstraints / details
Host including port:Proxy_SOCKSProxyText boxtextSOCKSProxyREG_SZ
Proxy_SOCKSVersionDrop-down listenumSOCKSVersionREG_DWORD
LabelValue
SOCKS v4REG_DWORD = 4
SOCKS v5REG_DWORD = 5

Application

Mozilla Firefox (Mozilla) — November 2026 templates

Official templates downloaded on November 12, 2026.