| Previous | Next |
| ERROR_RWRAW_ENCRYPTED_INVALID_EDATAINFO_PARAMETER | ERROR_CAPAUTHZ_NOT_DEVUNLOCKED |
ERROR_LINUX_SUBSYSTEM_NOT_PRESENT
Windows Subsystem for Linux is unavailable
ERROR_LINUX_SUBSYSTEM_NOT_PRESENT indicates that an operation requires WSL, but the subsystem or its required Windows features are not present. It is a capability and installation-state error, not evidence that a particular Linux distribution is corrupt.
Common scenarios
- Launching a Linux executable or WSL command on a system where WSL is disabled.
- Running automation on a Windows edition or image that omits optional components.
- Using a freshly provisioned host before required features and reboot steps complete.
- Calling WSL-dependent tooling inside a restricted server or container environment.
Diagnosis
Check Windows version, optional-feature state, virtualization requirements for the selected WSL generation, and whether a reboot is pending. Then distinguish subsystem absence from “no distribution installed” and from a distribution-specific startup failure.
Handling
Offer a documented installation path or disable the WSL-dependent feature. Do not retry continuously. Enterprise software should allow administrators to preflight and deploy prerequisites.
Developer guidance
Detect WSL capability before exposing commands that require it, and provide a native Windows fallback when practical.
References
Looking for a different code? Search another status or error code.