Skip to content

Commit ebe60f9

Browse files
Copilotmattwojo
andauthored
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>
1 parent 4e025c8 commit ebe60f9

1 file changed

Lines changed: 5 additions & 1 deletion

File tree

WSL/wsl-config.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Advanced settings configuration in WSL
33
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
55
ms.topic: article
66
---
77

@@ -231,6 +231,7 @@ This file can contain the following options that affect the VM that powers any W
231231
| `swapFile` | path | `%USERPROFILE%\AppData\Local\Temp\swap.vhdx` | An absolute Windows path to the swap virtual hard disk. |
232232
| `guiApplications` | boolean | `true` | Boolean to turn on or off support for GUI applications ([WSLg](https://github.com/microsoft/wslg)) in WSL. |
233233
| `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. |
234235
| `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. |
235236
| `vmIdleTimeout`* | number | `60000` | The number of milliseconds that a VM is idle, before it is shut down. Only available for Windows 11. |
236237
| `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
309310
# Turns on output console showing contents of dmesg when opening a WSL 2 distro for debugging
310311
debugConsole=true
311312

313+
# Sets the maximum number of crash dump files to retain (default is 5)
314+
maxCrashDumpCount=10
315+
312316
# Enable experimental features
313317
[experimental]
314318
sparseVhd=true

0 commit comments

Comments
 (0)