WSL

Imported from Notion: WSL

updated:: 2026.07.10

Qué resuelve

Configuración básica de WSL 2 para limitar memoria, CPU, swap y reiniciar el entorno cuando la VM queda consumiendo recursos.

[!NOTE] ✅ .wslconfig se aplica a todas las distribuciones WSL 2 del usuario Windows. Va en %UserProfile%\.wslconfig, por ejemplo C:\Users\TU_USUARIO\.wslconfig.

Config recomendada

[wsl2]
memory=4GB
processors=4
swap=0
localhostForwarding=true

Qué hace:

Opción	Efecto
`memory=4GB`	Limita la RAM máxima de la VM WSL 2
`processors=4`	Limita CPUs lógicas asignadas
`swap=0`	Desactiva swap de WSL 2
`localhostForwarding=true`	Permite acceder desde Windows por `localhost` a servicios en WSL

[!NOTE] ⚠️ swap=0 reduce margen ante cargas pesadas. Si compilas, usas Docker o procesos grandes, considera swap=2GB o más.

Aplicar cambios

Desde PowerShell:

wsl --shutdown

Después vuelve a abrir tu distro.

Ver distros en ejecución:

wsl --list --running

Ver distros instaladas:

wsl --list --verbose

Perfiles útiles

Conservador

[wsl2]
memory=2GB
processors=2
swap=0

Equilibrado

[wsl2]
memory=4GB
processors=4
swap=2GB
localhostForwarding=true

Trabajo pesado

[wsl2]
memory=8GB
processors=6
swap=4GB
localhostForwarding=true

Diagnóstico dentro de WSL

free -h
nproc
df -h
ip addr

Ver memoria desde Windows:

Get-Process vmmemWSL

Errores comunes

Problema	Causa probable	Solución
La RAM no baja tras editar `.wslconfig`	WSL no se reinició	`wsl --shutdown`
WSL ignora config	Archivo en ruta incorrecta	Debe estar en `%UserProfile%\.wslconfig`
Una distro necesita config propia	`.wslconfig` es global	Usa `/etc/wsl.conf` dentro de la distro
Se quedan procesos colgados	La VM sigue activa	`wsl --list --running` y `wsl --terminate DISTRO`
Fallan cargas pesadas	Memoria/swap demasiado bajas	Sube `memory` o `swap`

Referencias

Configuración avanzada WSL: https://learn.microsoft.com/en-us/windows/wsl/wsl-config
Comandos básicos WSL: https://learn.microsoft.com/en-us/windows/wsl/basic-commands

- EOF -