How To Disable The WSL Debug Console Window On Startup

Table of contents

• 1. Open Your User Folder
• 2. Locate or Create the .wslconfig File
• 3. Remove the Debug Console Setting
• 4. Apply the Change

This quick fix is for that strange "WSL debug console" window that pops up when you open Windows File Explorer.

It's triggered by a setting in your system, and the solution is to simply turn it off.

Follow the steps below to disable it.

1. Open Your User Folder

Open up File Explorer and type this into the address bar:

✅ Wrap📋
$ %userprofile%

Hit Enter. This will take you to your user directory, usually something like C:\Users\yourname.

2. Locate or Create the .wslconfig File

Look for a file named .wslconfig.

• If it exists, right-click and choose Open with > Notepad (or any text editor of your choice).
• If it doesn't exist, right-click anywhere > New > Text Document, and rename it to:

✅ Wrap📋
$ .wslconfig

Make sure file extensions are visible so it doesn't end up as .wslconfig.txt. If you are not seeing extensions, go to the View tab in File Explorer and check File name extensions.

3. Remove the Debug Console Setting

Inside .wslconfig, look for a block like this:

✅ Wrap📋
01: [wsl2]
02: debugConsole=true

Change the this setting to false:

✅ Wrap📋
01: [wsl2]
02: debugConsole=false

4. Apply the Change

Restart your PC to allow the changes to take effect.

That's it. No more surprise debug console on startup.

Here is another article you might like 😊 How To Override The Default 404 Error Page In Laravel 12