Where is wsl config

Content on WhatAnswers is provided "as is" for informational purposes. While we strive for accuracy, we make no guarantees. Content is AI-assisted and should not be used as professional advice.

Last updated: April 17, 2026

Quick Answer: The WSL configuration file is located at /etc/wsl.conf on Linux distributions running under Windows Subsystem for Linux. Users can customize startup behavior, networking, and filesystem options by editing this file.

Key Facts

The WSL config file is named wsl.conf and located at /etc/wsl.conf
WSL 1 was released in 2016, with WSL 2 introduced in 2019
Editing wsl.conf allows customization of boot behavior and filesystems
The [boot] section supports options like systemd=true for automatic startup
Microsoft officially supports Ubuntu, Debian, SUSE, and Alpine on WSL

Overview

Windows Subsystem for Linux (WSL) enables users to run a Linux environment directly on Windows without dual-booting or virtual machines. A core component of WSL customization is the configuration file, which controls system behavior and integration settings.

Located at /etc/wsl.conf, this file allows fine-tuning of Linux distribution settings within WSL. Understanding its location and structure helps users optimize performance, startup routines, and filesystem interoperability between Windows and Linux.

File location: The primary WSL configuration file is stored at /etc/wsl.conf within each Linux distribution installed via WSL.
Editing access: Users must edit wsl.conf using root privileges via sudo nano /etc/wsl.conf or another terminal-based editor.
Configuration sections: The file supports sections like [automount], [network], [interop], and [boot], each governing different subsystem behaviors.
Automount options: The [automount] section can set enabled=true or options="metadata,umask=22,fmask=11" to control drive mounting behavior.
Networking control: The [network] section allows setting generateHosts=true or generateResolvConf=true to manage DNS and host file generation.

How It Works

The wsl.conf file is read by the WSL init process during distribution startup, applying user-defined settings before the shell launches. Each configuration directive modifies how WSL integrates Linux with the host Windows system.

Automount:enabled=true allows automatic mounting of Windows drives (e.g., C:\) under /mnt; setting it to false disables this feature.
Root filesystem: The root option in [automount] lets users change the default mount point for Windows drives, such as setting it to /windows.
Network settings:hostname=devbox in the [network] section sets a custom hostname instead of the default Windows machine name.
Interop control: The [interop] section supports enabled=false to block launching Windows executables from Linux, enhancing security.
Default user: The [user] section allows setting default=john to automatically log in as a specific Linux user at startup.
Systemd support: Adding systemd=true in the [boot] section enables systemd initialization, available in WSL 2 builds after 2021.

Comparison at a Glance

Key WSL configuration options and their effects across different versions:

Configuration	WSL 1 Support	WSL 2 Support	Default Value	Example Use
systemd=true	No	Yes (after 2021)	false	Run background services like MySQL automatically
automount.enabled	Yes	Yes	true	Disable C: drive auto-mount for security
network.generateHosts	Yes	Yes	true	Prevent automatic hosts file updates
interop.enabled	Yes	Yes	true	Block Windows .exe execution from Linux
user.default	Yes	Yes	root	Set non-root user as default login

This comparison highlights how configuration flexibility has evolved, especially with WSL 2’s improved kernel compatibility. While most settings work across versions, advanced features like systemd require newer Windows builds and proper kernel support. Users should verify their WSL version using wsl --version before applying complex configurations.

Why It Matters

Properly configuring wsl.conf enhances security, performance, and usability for developers and system administrators. These settings streamline workflows and reduce manual configuration after each reboot.

Security improvement: Disabling interop prevents accidental or malicious execution of Windows binaries from Linux shells.
Performance tuning: Setting automount.options="metadata" enables Linux permission support on NTFS drives, improving compatibility.
Developer workflow: Using systemd=true allows services like Docker or Apache to start automatically, mimicking production environments.
Network isolation: Setting generateHosts=false gives users full control over the /etc/hosts file in the Linux environment.
Multi-distro management: Each installed distribution maintains its own wsl.conf, allowing customized settings per environment.
Migration readiness: Standardized configuration files make it easier to replicate setups across machines or teams.

As WSL continues to evolve, mastering configuration through wsl.conf ensures users can fully leverage Linux integration on Windows for development, scripting, and system administration.