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
Add missing MaxCrashDumpCount documentation to .wslconfig options (#2281)
* Initial plan
* Add MaxCrashDumpCount documentation to .wslconfig options
Co-authored-by: mattwojo <7566797+mattwojo@users.noreply.github.com>
* Update date metadata and add more context to description
* Update default max crash dump
---------
Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: mattwojo <7566797+mattwojo@users.noreply.github.com>
Co-authored-by: Matt Wojciakowski <mattwoj@microsoft.com>
Copy file name to clipboardExpand all lines: WSL/wsl-config.md
+5-1Lines changed: 5 additions & 1 deletion
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: 05/19/2025
4
+
ms.date: 07/31/2025
5
5
ms.topic: article
6
6
---
7
7
@@ -231,6 +231,7 @@ This file can contain the following options that affect the VM that powers any W
231
231
|`swapFile`| path |`%USERPROFILE%\AppData\Local\Temp\swap.vhdx`| An absolute Windows path to the swap virtual hard disk. |
232
232
|`guiApplications`| boolean |`true`| Boolean to turn on or off support for GUI applications ([WSLg](https://github.com/microsoft/wslg)) in WSL. |
233
233
|`debugConsole`*| boolean |`false`| Boolean to turn on an output console Window that shows the contents of `dmesg` upon start of a WSL 2 distro instance. Only available for Windows 11. |
234
+
|`maxCrashDumpCount`| number |`10`| Set the maximum number of crash dump files that will be retained for debugging purposes. The default number retained by WSL is 10. When this limit is exceeded, older crash dumps will be automatically deleted to make room for new ones. Setting a max can help with reducing the amount of disk space used by these crash files. |
234
235
|`nestedVirtualization`*| boolean |`true`| Boolean to turn on or off nested virtualization, enabling other nested VMs to run inside WSL 2. Only available for Windows 11. |
235
236
|`vmIdleTimeout`*| number |`60000`| The number of milliseconds that a VM is idle, before it is shut down. Only available for Windows 11. |
236
237
|`dnsProxy`| boolean |`true`| Only applicable to networkingMode = NAT. Boolean to inform WSL to configure the DNS Server in Linux to the NAT on the host. Setting to false will mirror DNS servers from Windows to Linux. |
@@ -309,6 +310,9 @@ nestedVirtualization=false
309
310
# Turns on output console showing contents of dmesg when opening a WSL 2 distro for debugging
310
311
debugConsole=true
311
312
313
+
# Sets the maximum number of crash dump files to retain (default is 5)
0 commit comments