Setup & Config WSL

Før du bruker WSL Dashboard, må Windows-systemet ditt ha WSL 2 aktivert og konfigurert på riktig måte. Dette dokumentet består av følgende tre hoveddeler:

1. Aktivere og konfigurere WSL: fullfør basisinstallasjonen og konfigurasjonen av WSL 2.
2. Et tilgjengelig kommando betyr ikke vellykket installasjon: forklarer at et kjørbart wsl-kommando ikke betyr at Linux kan installeres.
3. Feilsøking av mislykket installasjon: kontroll- og reparasjonsmetoder når installasjonen fortsatt mislykkes etter konfigurasjonen.

1. Aktivere og konfigurere WSL

Dette kapittelet veileder deg gjennom de nødvendige grunninnstillingene. Etter dette kapittelet, les kapittel 2 for å forstå forskjellen mellom et tilgjengelig kommando og en vellykket installasjon; hvis installasjonen fortsatt gir problemer, se kapittel 3.

1.1 Kontroller systemkravene

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

• Windows 10: versjon 1903 eller nyere, med build-nummer (Build) 18362 eller høyere.
• 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å virtualiseringsteknologi (Virtualization Technology) må være aktivert i hovedkortets BIOS/UEFI.

• Kontrollmetode: åpne "Oppgavebehandlingen" → fanen "Ytelse" → "Prosessor".
• Kontroller statusen: bekreft at statusen "Virtualisering" nederst til høyre viser "Aktivert".
• Aktivering: hvis den ikke er aktivert, må du starte datamaskinen på nytt, gå inn i BIOS/UEFI-innstillingene, finne et alternativ som Intel VT-x eller AMD-V og sette det til Enabled.

1.3 Aktiver Windows-relaterte funksjoner

Du må aktivere funksjonene "Windows-undersystem for Linux" og "Plattform for virtuelle maskiner".

Metode A: Via det grafiske grensesnittet (anbefales)

1. Trykk på Win + S, søk etter og åpne "Slå Windows-funksjoner på eller av".
2. Merk av følgende to alternativer:
   • Windows-undersystem for Linux (Windows Subsystem for Linux)
   • Plattform for virtuelle maskiner (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 plattform for virtuelle maskiner
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

Etter utførelse må du starte datamaskinen på nytt manuelt.

1.4 Installere eller oppdatere WSL-kjernen

Moderne Windows-versjoner kan få WSL-oppdateringer via Microsoft Store.

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

1.5 Angi WSL 2 som standardversjon

For å sikre at nyinstallerte distribusjoner bruker WSL 2 som standard, kjør følgende i terminalen:

wsl --set-default-version 2

1.6 Vanlige spørsmål

• Feil 0x80370102: skyldes vanligvis at virtualisering ikke er aktivert i BIOS, eller en konflikt med Hyper-V.
• Bytte mellom WSL 1 og WSL 2: du kan bruke wsl --set-version <分发版名称> 2 til å oppgradere en eksisterende WSL 1-forekomst til WSL 2.

2. Et tilgjengelig kommando betyr ikke vellykket installasjon

At kommandoer som wsl --version og wsl -l -v kjører normalt, betyr ikke at betingelsene for å installere Linux allerede er oppfylt. De befinner seg i ulike faser og kan ikke settes likhetstegn mellom.

At kommandoen er tilgjengelig, sier bare at:

• ✅ WSL-komponentene i Windows allerede er aktivert/installert
• ✅ kommandolinjeverktøyet wsl.exe er tilgjengelig
• ✅ systemet kjenner igjen WSL-relaterte kommandoer

Men for å installere en Linux-distribusjon må tilleggsbetingelser være oppfylt. Vanlige flaskehalser er:

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-versjon/-build er for lav: WSL 2 har krav til kjerne og versjon; hjemmeversjonen og for gamle bedriftsavbildninger kan mangle funksjoner (kontrollmetode: se 1.1 Kontroller systemkravene).
3. Ingen Linux-distribusjon er faktisk installert ennå: wsl -l -v lister bare installerte distribusjoner; hvis ingenting er installert, er listen tom, noe som ikke betyr at Ubuntu kan kjøres direkte.
4. Nettverks-/Microsoft Store-problemer: wsl --install -d <发行版> må hente avbildninger fra Store eller nettverket; bedriftsnettverk, proxyer og brannmurer kan blokkere dette.
5. Utilstrekkelige rettigheter: installasjon av en distribusjon eller endring av WSL-innstillinger krever administratorrettigheter.

TIP

Kort sagt: at WSL-kommandoen virker er ikke lik at Linux er klart; du har bare fått "inngangsbilletten", systemet er ennå ikke faktisk installert.

3. Feilsøking av mislykket installasjon

Hvis wsl --install fortsatt mislykkes etter at du har fullført konfigurasjonen i henhold til kapittel 1 (eller når du tror du har fullført konfigurasjonen), kontroller i følgende rekkefølge.

3.1 Start med en one-click-sjekk

Kjør PowerShell som administrator og utfør følgende i rekkefølge:

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

• ✅ Hvis begge kommandoene kjører uten problemer, betyr det at WSLs valgfrie komponenter er aktivert og at virtualiseringsbetingelsene i stor grad er oppfylt.
• ❌ Hvis de mislykkes, angis det direkte hva som mangler (f.eks. Plattform for virtuelle maskiner, Hyper-V, BIOS-virtualisering osv.).

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

NOTE

Ingen kommando kan garantere 100 % at wsl --install lykkes, men kontrollene ovenfor bekrefter om installasjonsbetingelsene er oppfylt.

3.2 Manuell kontrolliste

Hvis one-click-sjekken ikke kan lokalisere problemet, kontroller punkt for punkt:

1. Kontroller om BIOS-/fastvarevirtualisering er aktivert: kjør systeminfo i en PowerShell med administratorrettigheter; i utdataene må Virtualization Enabled In Firmware: Yes synes.
2. Kontroller om Windows-funksjonene er aktivert:

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

   Statusen for begge kommandoene skal være Enabled.
3. Kontroller om WSL er tilgjengelig: wsl --version skal gi normale utdata; hvis kommandoen ikke finnes, betyr det at WSL-komponentene ikke er installert – gå tilbake til kapittel 1.
4. Kontroller om WSL 2 kan brukes (kjerne og plattform for virtuelle maskiner): wsl --set-default-version 2 skal returneres vellykket. Vanlige årsaker: Plattform for virtuelle maskiner er ikke aktivert, eller VT-x / AMD-V er ikke aktivert i BIOS.

3.3 Rask oversikt over vanlige feilårsaker

Situasjon	Forklaring	Løsning
Virtualisering ikke aktivert i BIOS	Mislykkes garantert	Start på nytt, gå inn i BIOS og 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 bedriftsmiljø	Kan mislykkes	Kontakt systemadministratoren
Gammel hjemmeversjon av systemet	Krever manuell installasjon	Installer WSL-kjernen manuelt i henhold til 1.4

3.4 Feil 0xc03a0014: finner ikke leverandør for virtuell diskstøtte

Feilmeldingen er Cannot find a virtual disk support provider for the specified file. Dette er ikke et problem med selve Linux-distribusjonen, men Windows' virtuelle diskstabel (VHD/VHDX) fungerer ikke som den skal; WSL 2 mislykkes når den registrerer en distribusjon og oppretter/monterer ext4.vhdx.

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

Løs problemet i følgende rekkefølge:

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

2. WSL / Plattform for virtuelle maskiner er ikke aktivert (eller ikke trådt i kraft): kjør kommandoene i 1.3 Aktiver Windows-relaterte funksjoner på nytt, og start deretter datamaskinen på nytt – dette er obligatorisk. Windows Home har ikke fullstendig Hyper-V, men WSL 2 trenger bare Plattform for virtuelle maskiner, ikke Hyper-V-administrasjonsgrensesnittet.

3. Drivere/enheter for virtuelle disker mangler: åpne Enhetsbehandling og kontroller under "Systemenheter / Lagringskontrollere" om følgende finnes:

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

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

4. Importert avbildning oppfyller ikke WSL-kravene: ved bruk av wsl --import --vhd må VHDX ha filsystemet ext4; det kan ikke være 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. Bane-/rettighets-/filsystemproblemer: målmappen må ligge på en NTFS-disk (FAT32/exFAT fungerer ikke); unngå kinesiske tegn, mellomrom og spesialtegn i banen; ikke importer fra nettverksdisker, OneDrive eller komprimerte mapper; bruk alltid en ekte PowerShell med administratorrettigheter (ikke en vanlig terminal).

6. Skadede systemkomponenter: kjør DISM og SFC i rekkefølge for å reparere systemkomponentene, og prøv deretter på nytt:

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

TIP

Virtuelle maskiner fra tredjepart (VirtualBox, VMware) eller sandkasse-/herdingsfunksjoner i sikkerhetsprogramvare (f.eks. 360, Huorong) kan forstyrre operasjoner med virtuelle disker; deaktiver dem midlertidig under feilsøkingen og prøv igjen.