You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Fix stale systemd note, Insider Build qualifier, crash dump default, and typo in wsl-config
- Remove 'recently added' language for systemd support (added in 2022,
now standard) and drop link to the outdated Store preview blog post
- Remove version 0.67.6+ requirement mention (all current WSL versions support it)
- Change 'Insider Build 17713' to 'Windows Build 17713' — this shipped
in 2018 and is no longer an Insider-only build
- Fix comment in .wslconfig example: maxCrashDumpCount default was
listed as 5 but the reference table correctly states 10
- Fix typo: 'custum' -> 'custom' in kernelModules comment
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copy file name to clipboardExpand all lines: WSL/wsl-config.md
+5-5Lines changed: 5 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,7 +1,7 @@
1
1
---
2
2
title: Advanced settings configuration in WSL
3
3
description: A guide to the wsl.conf and .wslconfig files used for configuring settings when running multiple Linux distributions on Windows Subsystem for Linux.
4
-
ms.date: 07/31/2025
4
+
ms.date: 04/15/2026
5
5
ms.topic: article
6
6
---
7
7
@@ -45,7 +45,7 @@ The wsl.conf file supports four sections: `automount`, `network`, `interop`, and
45
45
46
46
### systemd support
47
47
48
-
Many Linux distributions run "systemd" by default (including Ubuntu) and WSL has recently added support for this system/service manager so that WSL is even more similar to using your favorite Linux distributions on a bare metal machine. You will need version 0.67.6+ of WSL to enable systemd. Check your WSL version with command `wsl --version`. If you need to update, you can grab the [latest version of WSL in the Microsoft Store](https://aka.ms/wslstorepage). Learn more in [blog announcement](https://devblogs.microsoft.com/commandline/a-preview-of-wsl-in-the-microsoft-store-is-now-available/).
48
+
Many Linux distributions run "systemd" by default (including Ubuntu) and WSL supports this system/service manager, making WSL even more similar to using your favorite Linux distributions on a bare metal machine. Check your WSL version with command `wsl --version`. If you need to update, you can grab the [latest version of WSL in the Microsoft Store](https://aka.ms/wslstorepage).
49
49
50
50
To enable systemd, open your `wsl.conf` file in a text editor using `sudo` for admin permissions and add these lines to the `/etc/wsl.conf`:
These options are available in Insider Build 17713 and later.
111
+
These options are available in Windows Build 17713 and later.
112
112
113
113
| Key | Value | Default | Notes |
114
114
|:----|:----|:----|:----|
@@ -290,7 +290,7 @@ processors=2
290
290
# Specify a custom Linux kernel to use with your installed distros. The default kernel used can be found at https://github.com/microsoft/WSL2-Linux-Kernel
291
291
kernel=C:\\temp\\myCustomKernel
292
292
293
-
# Specify the modules VHD for the custum Linux kernel to use with your installed distros.
293
+
# Specify the modules VHD for the custom Linux kernel to use with your installed distros.
294
294
kernelModules=C:\\temp\\modules.vhdx
295
295
296
296
# Sets additional kernel parameters, in this case enabling older Linux base images such as Centos 6
@@ -311,7 +311,7 @@ nestedVirtualization=false
311
311
# Turns on output console showing contents of dmesg when opening a WSL 2 distro for debugging
312
312
debugConsole=true
313
313
314
-
# Sets the maximum number of crash dump files to retain (default is 5)
314
+
# Sets the maximum number of crash dump files to retain (default is 10)
0 commit comments