Hardware FixRecommendedDevice not working? Your driver may be the problemCheck updates for common hardware issues.Fix DriversOctober DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsPC HealthRecommendedCrashes, freezes, slowdowns? Check your PC nowSpot repairable issues before they interrupt work.Check PC×
Skip to content
Redmond desk6 min

How to Fix Linux Tool Installation and Startup Problems on Windows 11

Use WSL’s standard install path on Windows 11, then troubleshoot Linux distribution installation and startup errors by matching the exact message to the right fix.
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

On Windows 11, the normal way to install Linux tools is to install a Linux distribution through Windows Subsystem for Linux (WSL), then install the tools inside that distribution. Start with wsl --install in PowerShell or Command Prompt, restart if prompted, and open the installed distribution once to finish its first-run setup. If setup or startup fails, use the exact error to choose a fix: a disabled WSL feature, a distribution stored off the system drive, a missing kernel update, and a shell or account mismatch need different checks.

Install a Linux distribution and start using its tools

Microsoft supports wsl --install on Windows 11 and Windows 10 version 2004 (Build 19041) or later. On a supported Windows 11 system, the command enables the WSL and Virtual Machine Platform components, installs the latest Linux kernel, sets WSL 2 as the default, and installs Ubuntu by default. Windows may ask you to restart.

As an Amazon Associate I earn from qualifying purchases.

  1. Open PowerShell or Command Prompt. If Windows needs to enable optional features, use an elevated shell and approve the prompt.
  2. Run wsl --install. To see available distributions, run wsl --list --online.
  3. To install a distribution other than the default, run wsl --install -d <DistributionName>, replacing the placeholder with a name from the online list.
  4. Restart Windows if requested, then launch the distribution from the Start menu or by entering its name in a terminal. Complete its first-run setup, including creating a Linux username and password.
  5. Install Linux applications and development tools from inside that distribution, using its package manager and the distribution’s instructions.

For command options such as --web-download, --location, --no-launch, and --no-distribution, consult Microsoft’s WSL installation guide and basic WSL commands. A Linux tool’s compatibility can depend on the distribution, its packages, and its interaction with Windows; installing WSL does not guarantee that every Linux program behaves identically to one running on a full Linux machine.

What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Choose the right installation route

Route When it fits What to expect
wsl --install Windows 11, or Windows 10 version 2004 (Build 19041) or later, when the standard setup is available. Enables required Windows components, installs the kernel, sets WSL 2 as default, and installs Ubuntu unless you choose another distribution. A restart may be required.
Manual installation The simple command is unsupported or unsuitable, or a managed environment does not allow Microsoft Store access. Follow Microsoft’s manual installation steps to enable WSL and Virtual Machine Platform, meet WSL 2 requirements, install or update the kernel if needed, set the default WSL version, and install a distribution. Microsoft also documents manual distribution installation for systems without Store access.

On a work-managed PC, follow your organization’s policy before changing Windows features or virtualization settings. Store availability and administrative permissions can affect which route is practical.

Fix the error that matches what you see

“WslRegisterDistribution failed with error: 0x8007019e”

This error indicates that the Windows Subsystem for Linux optional component is not enabled. Enable Windows Subsystem for Linux in the Windows Features dialog, or use Microsoft’s documented administrative command in the WSL troubleshooting guide. Restart if Windows requests it, then try launching the distribution again.

“Installation failed with error 0x80070003”

Check where Windows saves new apps. Open Settings → System → Storage → Advanced storage settings → Where new content is saved and check the setting for new apps. Microsoft’s troubleshooting guidance says WSL runs on the system drive, usually C:. If new apps are directed elsewhere, change the setting as appropriate and retry; do not assume that moving an existing distribution or choosing any alternate drive is supported in every setup.

Rank #2
Dell Latitude 5420 14" FHD Business Laptop Computer, Intel Quad-Core i5-1145G7, 16GB DDR4 RAM, 256GB SSD, Camera, HDMI, Windows 11 Pro (Renewed)
  • 256 GB SSD of storage.
  • Multitasking is easy with 16GB of RAM
  • Equipped with a blazing fast Core i5 2.00 GHz processor.

“Starting WSL or installing a distribution returns an error code” such as 0x80370102

For 0x80370102 and other WSL 2 virtualization or startup failures, check the machine’s WSL 2 requirements and confirm that Virtual Machine Platform is enabled. Also verify that hardware virtualization is enabled in firmware and that Windows or organizational policy does not block it. This error can have more than one cause, so check the conditions rather than applying a single fix blindly. Microsoft’s manual setup instructions describe the WSL 2 requirements.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

“The term ‘wsl’ is not recognized”

First check whether the WSL optional component is installed. Also consider which shell you opened and its architecture: Microsoft’s troubleshooting page documents a specific issue involving ARM64 shells. In PowerShell Core or Command Prompt, try wsl.exe. If that works while wsl does not in another shell, the problem may be how that shell resolves the command rather than a missing WSL installation.

Rank #3

“Windows Subsystem for Linux has no installed distributions”

After installing a distribution, launch it at least once so its first-run setup can complete. Also check which Windows account is running the command. Distributions belong to the Windows account that installed them; a separate built-in Administrator account does not automatically see another account’s distributions.

A kernel update message or error 0x1bc appears

The WSL kernel component may be missing or need an update. Enable WSL first, restart if required, and then use wsl --update. Microsoft notes that 0x1bc can appear when the system locale or display language is not English even when the underlying issue concerns the WSL 2 kernel component. See the troubleshooting guidance before interpreting the code as a different failure.

Rank #4
15.6 Inch Laptop Computer, N4020, 4GB DDR4 RAM, 128GB eMMC,with Windows 11
  • EFFORTLESS EVERYDAY PERFORMANCE: Powered by Intel Celeron N4020 processor and Windows 11 Home system, delivering reliable, low-power efficiency for daily tasks like document editing, email, online classes, and web browsing
  • 15.6-INCH FULL HD DISPLAY: Enjoy immersive visuals on the 15.6" FHD (1920x1080) anti-glare screen with micro-edge bezels. Delivers clear details and comfortable viewing for long study sessions, working on spreadsheets, and video playback
  • RESPONSIVE MULTITASKING & STORAGE: Built with 4GB LPDDR4 RAM and 128GB eMMC storage for smooth daily essential use. Expand your storage by up to 1TB via the integrated TF card slot to easily store movies, photos, and working files
  • ADVANCED CONNECTIVITY: Outfitted with 2x Full-Featured Type-C ports for data transfer, fast charging, and dual-monitor output, alongside 2x USB 3.2 Gen1 ports and a 3.5mm audio jack for complete peripheral compatibility
  • LIGHTWEIGHT & SILENT OPERATION: Slim and portable for effortless travel or commuting. Features a 1MP HD webcam for remote meetings, 38Wh battery with 45W Type-C fast charging, and a fanless silent design for peaceful work environments.

WSL hangs or returns an unexpected startup error

Check that the command and distribution name are correct, then try updating WSL and restarting its running instances:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
  • wsl --update updates WSL itself.
  • wsl --shutdown stops all running distributions. Start the distribution again afterward.
  • wsl --terminate <Distro> stops one named distribution without stopping the others.

These are update and restart actions, not universal repairs. If Windows itself may have damaged system files, Microsoft’s guidance for some startup errors such as 0x8000FFFF suggests considering SFC /SCANNOW or DISM /Online /Cleanup-Image /RestoreHealth from an elevated command prompt. Use these as conditional Windows repair checks, not guaranteed WSL fixes.

Best Value
Windows 11 Laptop with i3 Processor 15.6" Work Laptop for College Students
  • 【Efficient Performance】 Powered by Intel Core i3 processor (2 cores, 4 threads, up to 3.4GHz) with 12GB RAM and 256GB SSD. Handles multitasking, office software, online classes, and HD video streaming smoothly. Integrated Intel UHD Graphics 620
  • Backlit Keyboard & Complete Package】Comes with a cool backlit keyboard. Comes with awebcam, dual stereo speakers (8Ω/1.0W each), DC charger, and user manual – ready for late-night studying, online classes, video conferencing, and daily productivity
  • 【Vibrant Display】 15.6-inch Full HD (1920x1080) anti-glare screen with 16:9 aspect ratio delivers crisp images and vivid colors – perfect for studying, watching lectures, or entertainment. Thin-bezel design maximizes viewing area
  • 【Fast Connectivity & Expansion】 Equipped with WiFi 6 (802.11ax) and Bluetooth 5.2 for stable, high-speed wireless. Features 3 x USB 3.0, HDMI 2.1, Type-C (supports PD3.0 fast charging), and a TF card slot expandable up to 2TB – easily connect external monitors, mice, drives, or expand storage for all your files
  • 【Long Battery Life & Portable】 Built-in 11.55V 5000mAh/57.75Wh high-capacity battery delivers approximately 7 hours of mixed-use battery life – enough for a full day of classes and assignments. Lightweight at just 1.63kg (3.6 lbs) and 19.5mm thin, plus a compact packing size – easily slips into a backpack for campus, library, or coffee shop
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Keep WSL and Linux packages updated separately

WSL’s host components and the software installed inside a Linux distribution have separate update paths. Use wsl --update for WSL. To update Linux packages, open the affected distribution and use its package manager’s instructions; the command depends on the distribution. Updating WSL does not, by itself, update every application installed inside Ubuntu or another distribution.

Work out which layer is failing

A message from a Linux application is not necessarily a WSL installation problem. Narrow the failure to the layer that produced it before changing Windows settings or reporting a bug.

  • Windows or WSL host: Errors enabling WSL features, registering or starting distributions, or launching WSL itself point toward Windows configuration or the WSL stack.
  • Distribution or package manager: If the distribution starts but a package cannot be installed or updated, follow that distribution’s package-manager guidance.
  • Linux application: If only one Linux binary fails, the problem may be in the program or its assumptions. Microsoft’s WSL troubleshooting guide recommends reproducing Linux-binary problems on real Linux where practical; tools such as strace can help inspect system calls. Report a confirmed application or distribution defect to its maintainer rather than treating it as a WSL host issue.

Gather useful details if the problem persists

Record the exact command and full error text, and note whether the failure occurs during installation, first launch, or when starting a particular Linux program. Then collect the system and WSL details Microsoft identifies as useful:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
  • Windows version and build: run cmd.exe /c ver.
  • WSL version: run wsl --version. On older inbox WSL builds that do not support it, try wsl.exe --status.
  • Installed distributions and whether each uses WSL 1 or WSL 2: run wsl.exe -l -v.
  • The distribution name and version, kernel version, exact error, and any relevant third-party software or security tools.
  • Reproducible WSL logs, following Microsoft’s logging and reporting guidance.

Use those details to report a WSL-specific, reproducible failure to the WSL project. For a Linux program or distribution defect, contact that project’s maintainers instead.

Quick Recap

Bestseller No. 1
Bestseller No. 2
Dell Latitude 5420 14' FHD Business Laptop Computer, Intel Quad-Core i5-1145G7, 16GB DDR4 RAM, 256GB SSD, Camera, HDMI, Windows 11 Pro (Renewed)
Dell Latitude 5420 14" FHD Business Laptop Computer, Intel Quad-Core i5-1145G7, 16GB DDR4 RAM, 256GB SSD, Camera, HDMI, Windows 11 Pro (Renewed)
256 GB SSD of storage.; Multitasking is easy with 16GB of RAM; Equipped with a blazing fast Core i5 2.00 GHz processor.
$285.00
Bestseller No. 3
HP 14' HD Laptop, Windows 11, Intel Celeron Dual-Core Processor Up to 2.60GHz, 4GB RAM, 64GB SSD, Webcam, Dale Pink (Renewed)
HP 14" HD Laptop, Windows 11, Intel Celeron Dual-Core Processor Up to 2.60GHz, 4GB RAM, 64GB SSD, Webcam, Dale Pink (Renewed)
14" diagonal, 1366x768 resolution, HD BrightView LED, Glossy NON-TOUCH Display
$245.99

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More from the Wire

  1. World desk4 min
    How to Spot an AI Voice Scam Before Sending MoneyDon’t rely on how a caller sounds. Pause, call back through a known number, and verify the emergency with another trusted person before sending money.
  2. Mountain View desk4 min
    Google’s SynthID Detector: How to Check AI-Generated Images, Video and AudioGoogle’s SynthID Detector looks for an embedded watermark in supported images, video and audio. Here is what its results do—and do not—show.
  3. Redmond desk20 min
    How to create a link to File or Folder in Windows 11Windows 11 gives you several ways to point to a file or folder without moving or duplicating it. You can create a desktop shortcut,…
Recommended PC Tool
Recommended PC Tool
Crashes, No Sound, or Screen Glitches?Free driver scan
PC Slower Than It Used to Be?Free scan - under a minute

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.