Konfigurera WSL

Innan du använder WSL Dashboard måste WSL 2-miljön på ditt Windows-system vara korrekt aktiverad och konfigurerad. Detta dokument är indelat i tre huvuddelar:

1. Aktivera och konfigurera WSL: grundinstallation och konfiguration av WSL 2.
2. Tillgängligt kommando ≠ lyckad installation: förklarar att wsl-kommandon som kan köras inte betyder att Linux kan installeras framgångsrikt.
3. Felsökning av installationsfel: kontroll- och reparationsmetoder när installationen fortfarande misslyckas efter konfiguration.

1. Aktivera och konfigurera WSL

Detta kapitel vägleder dig genom nödvändiga grundinställningar. Läs efter avslut kapitel 2 för att förstå skillnaden mellan tillgängliga kommandon och lyckad installation; om installationen fortfarande ger problem, se kapitel 3.

1.1 Kontrollera systemkraven

WSL 2 ställer minimikrav på Windows-versionen. Tryck på Win + R och skriv winver för att kontrollera din version:

• Windows 10: version 1903 eller senare, med buildnummer 18362 eller senare.
• Windows 11: alla versioner stöds.

IMPORTANT

Om din version är för gammal, uppgradera först ditt system via "Windows Update".

1.2 Aktivera hårdvaruvirtualisering

WSL 2 är baserad på virtualiseringsteknik. Du måste därför aktivera virtualiseringsteknik (Virtualization Technology) i moderkortets BIOS/UEFI.

• Kontrollmetod: öppna "Aktivitetshanteraren" -> fliken "Prestanda" -> "CPU".
• Kontrollera status: bekräfta att statusen "Virtualisering" längst ner till höger visar "Aktiverad".
• Så här aktiverar du: om den inte är aktiverad måste du starta om datorn, gå in i BIOS/UEFI-inställningarna, hitta ett alternativ som Intel VT-x eller AMD-V och ställa in det på Enabled.

1.3 Aktivera relaterade Windows-funktioner

Du måste aktivera funktionerna "Windows Subsystem för Linux" och "Plattform för virtuella datorer" i Windows.

Metod A: via det grafiska gränssnittet (rekommenderad)

1. Tryck på Win + S, sök och öppna "Aktivera eller avaktivera Windows-funktioner".
2. Markera följande två alternativ:
   • Windows Subsystem för Linux (Windows Subsystem for Linux)
   • Plattform för virtuella datorer (Virtual Machine Platform)
3. Klicka på "OK" och starta om datorn när du uppmanas.

Metod B: via kommandoraden (administratörsbehörighet)

Kör PowerShell som administratör och utför följande kommandon:

# Aktivera WSL
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

# Aktivera plattform för virtuella datorer
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

Starta efter utförandet om datorn manuellt.

1.4 Installera/uppdatera WSL-kärnan

Moderna Windows-versioner kan hämta WSL-uppdateringar via Microsoft Store.

• Nedladdningsadress: Microsoft Store - Windows Subsystem for Linux
• Manuell nedladdning: om du inte kan använda Store kan du ladda ner det senaste .msixbundle- eller .msi-paketet från WSL GitHub Releases för offlineinstallation.

1.5 Ställ in WSL 2 som standardversion

För att säkerställa att nyinstallerade distributioner använder WSL 2 som standard, kör i terminalen:

wsl --set-default-version 2

1.6 Vanliga frågor

• Fel 0x80370102: vanligtvis för att virtualisering inte är aktiverad i BIOS, eller för att det finns en konflikt med Hyper-V.
• Växla mellan WSL 1 och WSL 2: du kan använda wsl --set-version <distributionens-namn> 2 för att uppgradera en befintlig WSL 1-instans till WSL 2.

2. Tillgängligt kommando ≠ lyckad installation

Att kommandon som wsl --version och wsl -l -v kan köras utan problem betyder inte att förutsättningarna för att installera Linux är uppfyllda. Det är olika faser och kan inte likställas.

Ett tillgängligt kommando betyder bara:

• ✅ Windows WSL-komponenter är aktiverade/installerade
• ✅ Kommandoradsverktyget wsl.exe är tillgängligt
• ✅ Systemet känner igen WSL-relaterade kommandon

Men för en lyckad installation av en Linux-distribution krävs ytterligare villkor. Vanliga hinder är:

1. Virtualisering avstängd: VT-x / AMD-V är inte aktiverat i BIOS/UEFI; WSL 2 kan inte starta, eller så rapporteras ett virtualiseringsfel vid installation av distributionen (kontrollmetod se 1.2 Aktivera hårdvaruvirtualisering).
2. Windows-version/buildnummer för gammalt: WSL 2 ställer krav på kärna och version; Home-utgåvan eller alltför gamla företagsavbildningar kan ha ofullständiga funktioner (kontrollmetod se 1.1 Kontrollera systemkraven).
3. Ingen Linux-distribution faktiskt installerad: wsl -l -v listar bara installerade distributioner; om inget är installerat är listan tom, vilket inte betyder att Ubuntu kan köras direkt.
4. Nätverks-/Microsoft Store-problem: wsl --install -d <distribution> måste hämta avbildningen från Store eller nätverket; företagsnätverk, proxyer och brandväggar kan blockera.
5. Otillräckliga behörigheter: att installera distributioner eller ändra WSL-inställningar kräver administratörsbehörighet.

TIP

Kort sagt: WSL-kommandon fungerar ≠ Linux är redo – du har bara fått "inträdesbiljetten", men ännu inget system installerat.

3. Felsökning av installationsfel

Om wsl --install fortfarande misslyckas efter konfiguration enligt kapitel 1 (eller om du tror att du är klar), kontrollera följande punkter i denna ordning.

3.1 Gör först "kontrollen med ett klick"

Kör PowerShell som administratör och utför i ordning:

wsl --install --no-distribution
wsl --set-default-version 2

• ✅ Om båda kommandona körs utan problem är de valfria WSL-komponenterna aktiverade och virtualiseringsvillkoren i stort sett uppfyllda.
• ❌ Vid fel visas direkt vad som saknas (t.ex. plattform för virtuella datorer, Hyper-V, BIOS-virtualisering osv.).

Kör sedan systeminfo och bekräfta att Virtualization Enabled In Firmware: Yes visas i utdata. Om inga fel uppstår kan du tryggt köra wsl --install för att installera en distribution.

NOTE

Inget kommando kan till 100 % garantera att wsl --install lyckas, men ovanstående kontroller bekräftar om installationsvillkoren är uppfyllda.

3.2 Manuell kontrollista

Om "kontrollen med ett klick" inte kan lokalisera problemet, kontrollera punkt för punkt:

1. Kontrollera BIOS/firmwarevirtualisering: kör systeminfo i PowerShell som administratör; utdata måste innehålla Virtualization Enabled In Firmware: Yes.
2. Kontrollera Windows-funktioner:

   Get-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux
   Get-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform

   Statusen för båda kommandona måste vara Enabled.
3. Kontrollera WSL-tillgänglighet: wsl --version bör ge normal utdata; om meddelandet om att kommandot inte finns visas är WSL-komponenterna inte installerade; gå tillbaka till kapitel 1.
4. Kontrollera WSL 2-användning (kärna & plattform för virtuella datorer): wsl --set-default-version 2 bör returnera framgångsrikt. Vanliga felorsaker: plattform för virtuella datorer är inte aktiverad, eller VT-x / AMD-V är inte aktiverat i BIOS.

3.3 Snabbreferens för vanliga felorsaker

Situation	Beskrivning	Åtgärd
Virtualisering inte aktiverad i BIOS	Säkert misslyckande	Starta om, öppna BIOS och aktivera VT-x / AMD-V (se 1.2)
Windows 10 äldre än 19041	wsl --install stöds inte	Uppgradera systemet (se 1.1)
Företagsmiljö med Hyper-V/virtualisering avstängt	Kan misslyckas	Kontakta systemadministratören
Gammal Home-utgåva	Kräver manuell installation	Installera WSL-kärnan manuellt enligt 1.4

3.4 Fel 0xc03a0014: hittar inte virtual disk-supportprovider

Felmeddelandet är Cannot find a virtual disk support provider for the specified file. Detta är inte ett problem med Linux-distributionen i sig, utan Windows VHD/VHDX-virtualdiskstacken fungerar inte korrekt; WSL 2 misslyckas när det registrerar en distribution eller skapar/monterar ext4.vhdx.

Gör först en minimal verifiering: kör PowerShell som administratör och testa New-VHD (t.ex. New-VHD -Path C:\test.vhdx -SizeBytes 1GB). Om även detta kommando rapporterar samma fel, ligger problemet till 100 % hos Windows, inte hos distributionen.

Felsök och reparera i följande ordning:

1. Virtual Disk-tjänsten körs inte: öppna services.msc, hitta Virtual Disk-tjänsten, ställ in starttyp på "Automatisk" och starta den.

2. WSL-/Virtual Machine Platform-funktionerna är inte aktiverade (eller inte verksamma): kör kommandona i 1.3 Aktivera relaterade Windows-funktioner igen och starta sedan om. Windows Home-utgåva har inte komplett Hyper-V, men WSL 2 behöver bara plattformen för virtuella datorer, inte Hyper-V-hanteringskonsolen.

3. Virtualdisksdrivrutinen/-enheterna saknas: öppna Enhetshanteraren och kontrollera under "Systemenheter / Lagringskontrollanter" om följande finns:

   • Microsoft Virtual Disk Provider
   • Microsoft Virtual Drive Enumerator
   • Microsoft VHD Loopback Controller

   Om de saknas kan du lägga till dem manuellt via hdwwiz.exe (lagringskontrollant → Microsoft → Microsoft VHD Loopback Controller) och bekräfta att FsDepends-tjänsten inte är avaktiverad.

4. Importerad avbild uppfyller inte WSL-kraven: vid wsl --import --vhd måste VHDX vara ett ext4-filsystem; inte en LUKS-krypterad disk, ingen vanlig raw.img, inget Live-ISO och ingen tom disk formaterad i NTFS/FAT. .img / .qcow2 / .iso kan inte användas direkt med wsl --import --vhd.

5. Sökvägs-/behörighets-/filsystemproblem: målkatalogen måste ligga på en NTFS-disk (FAT32/exFAT fungerar inte); undvik kinesiska tecken, mellanslag och specialtecken i sökvägen; importera inte från nätverksenheter, OneDrive eller komprimerade mappar; använd absolut en riktig PowerShell som administratör (inte en vanlig terminal).

6. Skadade systemkomponenter: kör DISM och SFC i tur och ordning för att reparera systemkomponenterna och försök sedan igen:

   DISM.exe /Online /Cleanup-Image /RestoreHealth
   sfc /scannow

TIP

Andra virtuella maskiner (VirtualBox, VMware) eller sandlådor/förstärkningsfunktioner i säkerhetsprogram (som 360, Huorong) kan störa virtualdiskoperationer; du kan tillfälligt stänga av dem och försöka igen under felsökningen.