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
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). WSL supports this system/service manager on recent versions of WSL from the Microsoft Store, making WSL even more similar to using your favorite Linux distributions on a bare metal machine. Check your WSL version with `wsl --version`. If you need to update, you can grab the [latest version of WSL in the Microsoft Store](https://aka.ms/wslstorepage). If `wsl --version` is not recognized, you are likely using an older inbox version of WSL that must be updated before systemd is available.
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 10 version 1809 (build 17763) 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