Konfigurer WSL

Før du bruker WSL Dashboard, må Windows-systemet ditt korrekt aktivere og konfigurere WSL 2-miljøet. Dette dokumentet er delt inn i følgende tre hoveddeler:

1. Aktiver og konfigurer WSL: Gjennomfør den grunnleggende installasjonen og konfigurasjonen av WSL 2.
2. Kommandoen er tilgjengelig ≠ installasjonen er vellykket: Forklarer at en kjørbar wsl-kommando ikke betyr at Linux kan installeres med suksess.
3. Feilsøking ved installasjonsfeil: Metoder for kontroll og reparasjon når installasjonen fortsatt feiler etter konfigurasjonen.

1. Aktiver og konfigurer WSL

Dette avsnittet veileder deg gjennom den nødvendige grunnleggende oppsettet. Når du har gjennomført dette avsnittet, ber vi deg lese kapittel 2 for å forstå forskjellen mellom en tilgjengelig kommando og en vellykket installasjon; hvis installasjonen fortsatt gir problemer, henvises til kapittel 3.

1.1 Kontroller systemkravene

WSL 2 har minimumskrav til Windows-versjonen. Trykk på Win + R, og skriv inn winver for å kontrollere versjonen din:

• Windows 10: versjon 1903 eller nyere, og buildnummeret må være 18362 eller nyere.
• Windows 11: Alle versjoner støttes.

IMPORTANT

Hvis versjonen din er for gammel, må du først oppgradere systemet via "Windows Update".

1.2 Aktiver maskinvarevirtualisering

WSL 2 kjører på virtualiseringsteknologi, så Virtualization Technology må aktiveres i hovedkortets BIOS/UEFI.

• Kontrollmetode: Åpne "Task Manager" -> fanen "Ytelse" -> "CPU".
• Se status: Kontroller at "Virtualisering" i nedre høyre hjørne vises som "Aktivert".
• Aktiveringsmetode: Hvis den ikke er aktivert, må du starte datamaskinen på nytt og gå inn i BIOS/UEFI-innstillingene, finne et alternativ som Intel VT-x eller AMD-V og sette det til Enabled.

1.3 Aktiver relevante Windows-funksjoner

Du må aktivere funksjonene "Windows Subsystem for Linux" og "Virtual Machine Platform".

Metode A: Via grafisk grensesnitt (anbefalt)

1. Trykk på Win + S, søk etter og åpne "Slå Windows-funksjoner på eller av".
2. Merk følgende to punkter:
   • Windows Subsystem for Linux
   • Virtual Machine Platform
3. Klikk på "OK", og start datamaskinen på nytt når du blir bedt om det.

Metode B: Via kommandolinjen (administratorrettigheter)

Kjør PowerShell som administrator og utfør følgende kommandoer:

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

# Aktiver Virtual Machine Platform
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

Når du er ferdig, må du manuelt starte datamaskinen på nytt.

1.4 Installer/oppdater WSL-kjernen

Nyere versjoner av Windows kan hente WSL-oppdateringer via Microsoft Store.

• Nedlastingsadresse: Microsoft Store - Windows Subsystem for Linux
• Manuell nedlasting: Hvis du ikke kan bruke butikken, kan du laste ned den nyeste .msixbundle- eller .msi-pakken fra WSL GitHub Releases for offline-installasjon.

1.5 Angi WSL 2 som standardversjon

For å sikre at nyinstallerte distribusjoner som standard bruker WSL 2, må du utføre følgende i terminalen:

wsl --set-default-version 2

1.6 Ofte stilte spørsmål

• Feil 0x80370102: Skyldes vanligvis at virtualisering ikke er aktivert i BIOS, eller at det er en konflikt med Hyper-V.
• Bytt mellom WSL 1 og WSL 2: Du kan oppgradere en eksisterende WSL 1-instans til WSL 2 med wsl --set-version <distribusjonsnavn> 2.

2. Kommandoen er tilgjengelig ≠ installasjonen er vellykket

At kommandoer som wsl --version og wsl -l -v kan kjøres normalt betyr ikke at betingelsene for installasjon av Linux er oppfylt. De to tingene befinner seg i forskjellige faser og kan ikke sidestilles.

At kommandoen er tilgjengelig betyr bare:

• ✅ WSL-komponenten i Windows er aktivert/installert
• ✅ Kommandolinjeverktøyet wsl.exe er tilgjengelig
• ✅ Systemet kan gjenkjenne WSL-relaterte kommandoer

Men en vellykket installasjon av en Linux-distribusjon krever ytterligere betingelser. Vanlige steder hvor man kan stå fast:

1. Virtualisering er slått av: VT-x / AMD-V er ikke aktivert i BIOS/UEFI, WSL 2 kan ikke starte, eller det rapporteres en virtualiseringsfeil ved installasjon av en distribusjon (kontrollmetode: se 1.2 Aktiver maskinvarevirtualisering).
2. Windows-versjonen/buildnummeret er for gammelt: WSL 2 har krav til kjerne og versjon; Home-versjonen og for gamle enterprise-bilder kan mangle funksjoner (kontrollmetode: se 1.1 Kontroller systemkravene).
3. Ingen Linux-distribusjon installert ennå: wsl -l -v viser bare installerte distribusjoner; hvis ingenting er installert, er listen tom — det betyr ikke at man kan kjøre Ubuntu direkte.
4. Nettverks-/Microsoft Store-problemer: wsl --install -d <distribusjon> må hente bilder fra butikken eller nettverket; bedriftsnettverk, proxyer og brannmurer kan blokkere.
5. Utilstrekkelige rettigheter: Installasjon av distribusjoner eller endring av WSL-innstillinger krever administratorrettigheter.

TIP

Kort sagt: En fungerende WSL-kommando ≠ Linux er klar, du har bare fått "adgangsbilletter", men systemet er ikke reelt installert ennå.

3. Feilsøking ved installasjonsfeil

Hvis wsl --install fortsatt feiler etter at du har gjennomført konfigurasjonen i henhold til kapittel 1 (eller hvis du mener du allerede har gjennomført den), må du kontrollere i følgende rekkefølge.

3.1 Start med "ett-klikks-kontroll"

Kjør PowerShell med administratorrettigheter og utfør i rekkefølge:

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

• ✅ Hvis begge kommandoene kan kjøres problemfritt, er WSL-valgfrie komponenter aktivert, og virtualiseringsbetingelsene er stort sett oppfylt.
• ❌ Hvis de feiler, vises det direkte hva som mangler (f.eks. Virtual Machine Platform, Hyper-V, BIOS-virtualisering osv.).

Kjør deretter systeminfo og bekreft at Virtualization Enabled In Firmware: Yes vises i utdataene. Hvis ingenting av ovenstående gir feil, kan du trygt kjøre wsl --install for å installere en distribusjon.

NOTE

Ingen kommando kan med 100 % garanti sikre at wsl --install lykkes, men kontrollen ovenfor kan bekrefte at installasjonsbetingelsene er oppfylt.

3.2 Manuell kontrollsjekkliste

Hvis "ett-klikks-kontroll" fortsatt ikke kan lokalisere problemet, kan du kontrollere punkt for punkt:

1. Kontroller om BIOS/fastvarevirtualisering er aktivert: Kjør systeminfo i administrator-PowerShell; utdataene må vise Virtualization Enabled In Firmware: Yes.
2. Kontroller om Windows-funksjoner er aktivert:

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

   Statusen for begge kommandoene må være Enabled.
3. Kontroller om WSL er tilgjengelig: wsl --version skal gi normale utdata; hvis kommandoen ikke finnes, er WSL-komponenten ikke installert — gå tilbake til kapittel 1.
4. Kontroller om WSL 2 kan brukes (kjerne & Virtual Machine Platform): wsl --set-default-version 2 skal returnere suksess. Vanlige feilårsaker: Virtual Machine Platform er ikke aktivert, eller VT-x / AMD-V er ikke aktivert i BIOS.

3.3 Hurtig oversikt over vanlige feilårsaker

Situasjon	Beskrivelse	Håndtering
Virtualisering ikke aktivert i BIOS	Feiler alltid	Start på nytt, gå inn i BIOS, aktiver VT-x / AMD-V (se 1.2)
Windows 10 lavere enn 19041	wsl --install støttes ikke	Oppgrader systemet (se 1.1)
Hyper-V / virtualisering deaktivert i enterprise-miljø	Kan feile	Kontakt systemadministratoren
Gammel Home-versjon	Krever manuell installasjon	Installer WSL-kjernen manuelt i henhold til 1.4

3.4 Feil 0xc03a0014: Finner ikke leverandør av støtte for virtuelle disker

Feilmeldingen er Cannot find a virtual disk support provider for the specified file. Dette er ikke et problem med selve Linux-distribusjonen, men Windows' VHD/VHDX-stak for virtuelle disker fungerer ikke korrekt, slik at WSL 2 feiler ved registrering av distribusjoner og opprettelse/montering av ext4.vhdx.

Utfør først en minimal verifisering: Kjør PowerShell som administrator og utfør en New-VHD-test (f.eks. New-VHD -Path C:\test.vhdx -SizeBytes 1GB). Hvis denne kommandoen også rapporterer samme feil, ligger problemet 100 % på Windows-siden og ikke hos distribusjonen.

Søk og rett i følgende rekkefølge:

1. Virtual Disk-tjenesten kjører ikke: Åpne services.msc, finn tjenesten Virtual Disk, sett starttypen til "Automatisk" og start den.

2. WSL / Virtual Machine Platform-funksjonen er ikke aktivert (eller ikke trådt i kraft): Kjør kommandoene i 1.3 Aktiver relevante Windows-funksjoner på nytt, og start deretter datamaskinen på nytt — dette er obligatorisk. Windows Home har ikke fullstendig Hyper-V, men WSL 2 krever bare Virtual Machine Platform, ikke Hyper-V-administrasjonsgrensesnittet.

3. Virtuell disk-driver/enhet mangler: Åpne Enhetsbehandling og kontroller om følgende finnes under "Systemenheter / Lagringskontrollere":

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

   Hvis de mangler, kan du legge dem til manuelt via hdwwiz.exe (Lagringskontrollere → Microsoft → Microsoft VHD Loopback Controller), og bekreft at tjenesten FsDepends ikke er deaktivert.

4. Det importerte bildet oppfyller ikke WSL-kravene: Ved bruk av wsl --import --vhd må VHDX-en være et ext4-filsystem, ikke en LUKS-kryptert disk, en vanlig raw.img, en Live ISO eller en tom disk formatert med NTFS/FAT. .img / .qcow2 / .iso kan ikke brukes direkte med wsl --import --vhd.

5. Sti-/rettighets-/filsystemproblemer: Målmappen må ligge på en NTFS-disk (FAT32/exFAT fungerer ikke); unngå kinesiske tegn, mellomrom og spesialtegn i stier; importer ikke fra nettverksstasjoner, OneDrive eller komprimerte mapper; bruk alltid en ekte administrator-PowerShell (ikke en vanlig terminal).

6. Systemkomponenter er skadet: Kjør DISM og SFC i rekkefølge for å reparere systemkomponenter, og prøv deretter på nytt:

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

TIP

Tredjeparts virtualiseringsmaskiner (VirtualBox, VMware) eller sandkasse-/herdingsfunksjoner i sikkerhetsprogramvare (f.eks. 360, Huorong) kan forstyrre virtuelle diskoperasjoner; de kan midlertidig deaktiveres under feilsøking.