Open in the explorer

Allowlist for WSL container registries

Type
Computer
GPO path
Computer Configuration › Policies › Administrative Templates › Windows Subsystem for Linux › WSL container
Supported on
SUPPORTED_Windows10
ADMX file
WSL.admx
Internal name
WSL/WSLContainerRegistryAllowlist

Explanation

When enabled, WSL container will only be allowed to pull images from the registries listed here. This affects both the WSL container CLI and all applications using the WSL container API.

Registry

HKEY_LOCAL_MACHINE\Software\Policies\WSL
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: WSL/WSLContainerRegistryAllowlist
$k = 'HKLM:\Software\Policies\WSL\WSLContainerRegistryAllowlist'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
# Allowed registries
# Non-additive list: existing values of the key are cleared first
if (Test-Path -Path $k) { (Get-Item -Path $k).Property | ForEach-Object { Remove-ItemProperty -Path $k -Name ([WildcardPattern]::Escape($_)) -ErrorAction SilentlyContinue } }
$values = @('<value1>', '<value2>')  # Replace the values with your own
$i = 1
foreach ($v in $values) { Set-ItemProperty -Path $k -Name ('AllowedRegistry' + $i) -Value $v -Type String; $i++ }

Disable

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

Revert to "Not configured"

# Revert to "Not configured": WSL/WSLContainerRegistryAllowlist
$k = 'HKLM:\Software\Policies\WSL\WSLContainerRegistryAllowlist'
Remove-Item -Path $k -Recurse -Force -ErrorAction SilentlyContinue

Options (1)

LabelControlRegistry valueREG typeConstraints / details
Allowed registriesWSLContainerRegistryAllowlist_InputList (table)listSoftware\Policies\WSL\WSLContainerRegistryAllowlistValues named “AllowedRegistry” + numberREG_SZ (values under the key)

Application

Windows Subsystem for Linux (WSL) (Microsoft) — November 2026 templates

Official templates downloaded on November 12, 2026.