Nastavenie a konfigurácia WSL

Pred použitím WSL Dashboard musí byť vo vašom systéme Windows správne povolené a nakonfigurované prostredie WSL 2. Tento dokument sa skladá z troch hlavných častí:

1. Povolenie a nastavenie WSL: dokončenie základnej inštalácie a konfigurácie WSL 2.
2. Dostupnosť príkazu neznamená úspešnú inštaláciu: vysvetlenie, že spustiteľnosť príkazu wsl neznamená úspešnú inštaláciu Linuxu.
3. Riešenie problémov s inštaláciou: kontrola a náprava, ak inštalácia po konfigurácii stále zlyháva.

1. Povolenie a nastavenie WSL

Táto kapitola vás prevedie nevyhnutným základným nastavením. Po jej dokončení si prečítajte kapitolu 2, aby ste pochopili rozdiel medzi dostupnosťou príkazu a úspešnou inštaláciou; ak inštalácia stále spôsobuje problémy, pozrite si kapitolu 3.

1.1 Kontrola systémových požiadaviek

WSL 2 má minimálne požiadavky na verziu Windows. Stlačte Win + R, zadajte winver a skontrolujte svoju verziu:

• Windows 10: verzia 1903 alebo novšia, číslo zostavenia (Build) musí byť 18362 alebo novšie.
• Windows 11: podporované sú všetky verzie.

IMPORTANT

Ak je vaša verzia príliš stará, najprv systém aktualizujte cez „Windows Update“.

1.2 Zapnutie hardvérovej virtualizácie

WSL 2 beží na technológii virtualizácie, preto musí byť v BIOS/UEFI základnej dosky povolená technológia virtualizácie (Virtualization Technology).

• Ako skontrolovať: otvorte „Správca úloh“ → kartu „Výkon“ → „Procesor“.
• Ako zistiť stav: overte, že stav „Virtualizácia“ v pravom dolnom rohu je „Povolené“.
• Ako zapnúť: ak nie je zapnutá, reštartujte počítač, vstúpte do nastavení BIOS/UEFI, nájdite možnosť podobnú Intel VT-x alebo AMD-V a nastavte ju na Enabled.

1.3 Povolenie príslušných funkcií Windows

Je potrebné zapnúť funkcie „Subsystém Windows pre Linux“ a „Platforma virtuálnych počítačov“.

Spôsob A: cez grafické rozhranie (odporúčané)

1. Stlačte Win + S, vyhľadajte a otvorte „Zapnúť alebo vypnúť funkcie systému Windows“.
2. Začiarknite nasledujúce dve položky:
   • Subsystém Windows pre Linux (Windows Subsystem for Linux)
   • Platforma virtuálnych počítačov (Virtual Machine Platform)
3. Kliknite na „OK“ a pri výzve reštartujte počítač.

Spôsob B: cez príkazový riadok (oprávnenia správcu)

Spustite PowerShell ako správca a vykonajte nasledujúce príkazy:

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

# Povolenie platformy virtuálnych počítačov
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

Po dokončení príkazov reštartujte počítač manuálne.

1.4 Inštalácia/aktualizácia jadra WSL

Moderné verzie Windows môžu získavať aktualizácie WSL z Microsoft Store.

• Adresa stiahnutia: Microsoft Store – Windows Subsystem for Linux
• Manuálne stiahnutie: ak obchod nie je k dispozícii, možno najnovšie balíky .msixbundle alebo .msi stiahnuť pre offline inštaláciu zo stránky WSL GitHub Releases.

1.5 Nastavenie WSL 2 ako predvolenej verzie

Aby ste zabezpečili, že novo nainštalované distribúcie budú v predvolenom nastavení používať WSL 2, spustite v termináli:

wsl --set-default-version 2

1.6 Často kladené otázky

• Chyba 0x80370102: zvyčajne znamená, že virtualizácia nie je povolená v BIOS, alebo dochádza ku konfliktu s Hyper-V.
• Prepínanie medzi WSL 1 a WSL 2: pomocou wsl --set-version <názov distribúcie> 2 môžete inovovať existujúcu inštanciu WSL 1 na WSL 2.

2. Dostupnosť príkazu neznamená úspešnú inštaláciu

To, že príkazy wsl --version, wsl -l -v atď. fungujú správne, neznamená, že sú splnené podmienky na inštaláciu Linuxu. Ide o rôzne fázy, ktoré nemožno stotožňovať.

Dostupnosť príkazu znamená iba to, že:

• ✅ Komponenty WSL vo Windows sú povolené/nainštalované
• ✅ Nástroj príkazového riadka wsl.exe je k dispozícii
• ✅ Systém rozpoznáva príkazy súvisiace s WSL

Pre úspešnú inštaláciu distribúcie Linuxu sú však potrebné ďalšie podmienky. Bežné miesta, kde sa zaseknete:

1. Vypnutá virtualizácia: v BIOS/UEFI nie sú zapnuté VT-x / AMD-V, WSL 2 sa nemôže spustiť alebo pri inštalácii distribúcie hlási chybu virtualizácie (kontrola viď 1.2 Zapnutie hardvérovej virtualizácie).
2. Príliš stará verzia/číslo zostavenia Windows: WSL 2 má požiadavky na jadro a verziu; domáce edície alebo príliš staré podnikové obrazy môžu postrádať funkcie (kontrola viď 1.1 Kontrola systémových požiadaviek).
3. Distribúcia Linuxu ešte nie je skutočne nainštalovaná: wsl -l -v vypisuje iba nainštalované distribúcie; ak nie je nainštalované nič, je zoznam prázdny — to neznamená, že možno rovno spustiť Ubuntu.
4. Problémy so sieťou / Microsoft Store: wsl --install -d <distribúcia> sťahuje obrazy z obchodu alebo siete; firemné siete, proxy a brány firewall môžu blokovať.
5. Nedostatočné oprávnenia: inštalácia distribúcií alebo zmena nastavení WSL vyžaduje oprávnenia správcu.

TIP

Jednoducho povedané: fungujúce príkazy WSL ≠ Linux pripravený — máte len „vstupenku“, ale systém ešte skutočne nie je nainštalovaný.

3. Riešenie problémov s inštaláciou

Ak po dokončení konfigurácie podľa kapitoly 1 (alebo ak si myslíte, že ste konfiguráciu dokončili) príkaz wsl --install stále zlyháva, skontrolujte v nasledujúcom poradí.

3.1 Najprv „rýchle overenie“

Spustite PowerShell ako správca a postupne vykonajte:

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

• ✅ Ak oba príkazy prebehnú bez chýb, voliteľné komponenty WSL sú povolené a podmienky virtualizácie sú v zásade splnené.
• ❌ Pri zlyhaní systém priamo oznámi, čo chýba (napr. platforma virtuálnych počítačov, Hyper-V, virtualizácia v BIOS atď.).

Potom spustite systeminfo a overte, že sa vo výstupe objaví Virtualization Enabled In Firmware: Yes. Ak nikde nie sú chyby, môžete sa bez obáv pustiť do wsl --install pre inštaláciu distribúcie.

NOTE

Žiadny príkaz nemôže na 100 % zaručiť úspech wsl --install, ale vyššie uvedené kontroly potvrdzujú, či sú splnené podmienky inštalácie.

3.2 Ručný kontrolný zoznam

Ak „rýchle overenie“ problém neodhalí, skontrolujte položku po položke:

1. Overenie zapnutej virtualizácie v BIOS/firmvéri: spustite systeminfo v PowerShelli ako správca; vo výstupe musí byť riadok Virtualization Enabled In Firmware: Yes.
2. Overenie povolených funkcií Windows:

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

   Stav oboch príkazov by mal byť Enabled.
3. Overenie dostupnosti WSL: wsl --version by mal poskytnúť normálny výstup; ak systém hlási, že príkaz neexistuje, komponenty WSL nie sú nainštalované — vráťte sa k kapitole 1.
4. Overenie možnosti použiť WSL 2 (jadro a platforma virtuálnych počítačov): wsl --set-default-version 2 by mal úspešne vrátiť. Časté príčiny zlyhania: nie je povolená platforma virtuálnych počítačov, alebo v BIOS nie sú zapnuté VT-x / AMD-V.

3.3 Rýchly prehľad častých príčin zlyhania

Situácia	Popis	Riešenie
V BIOS nie je povolená virtualizácia	Isté zlyhanie	Reštartujte, vstúpte do BIOS a zapnite VT-x / AMD-V (viď 1.2)
Windows 10 nižší ako 19041	wsl --install nie je podporovaný	Aktualizujte systém (viď 1.1)
V podnikovom prostredí je zakázaný Hyper-V / virtualizácia	Možné zlyhanie	Kontaktujte správcu systému
Stará domáca edícia	Vyžaduje manuálnu inštaláciu	Manuálne nainštalujte jadro WSL podľa 1.4

3.4 Chyba 0xc03a0014: nebol nájdený poskytovateľ podpory virtuálnych diskov

Chybové hlásenie: Cannot find a virtual disk support provider for the specified file. To nie je problém samotnej distribúcie Linuxu, ale zásobník virtuálnych diskov VHD/VHDX systému Windows nefunguje správne — WSL 2 zlyháva pri registrácii distribúcie, vytváraní/pripájaní ext4.vhdx.

Najprv minimálne overenie: spustite v PowerShelli ako správca test New-VHD (napr. New-VHD -Path C:\test.vhdx -SizeBytes 1GB). Ak tento príkaz hlási rovnakú chybu, problém je na 100 % na strane Windows a nesúvisí s distribúciou.

Overujte a opravujte v tomto poradí:

1. Služba Virtual Disk nebeží: otvorte services.msc, nájdite službu Virtual Disk, nastavte typ spúšťania na „Automaticky“ a spustite ju.

2. Funkcie WSL / platforma virtuálnych počítačov nie sú povolené (alebo sa neprejavili): znova spustite príkazy z 1.3 Povolenie príslušných funkcií Windows a potom je potrebné reštartovať. Domáca edícia Windows nemá plný Hyper-V, ale WSL 2 potrebuje iba platformu virtuálnych počítačov, nie rozhranie na správu Hyper-V.

3. Chýbajúci ovládač/zariadenie virtuálneho disku: otvorte Správcu zariadení a skontrolujte, či v „Systémové zariadenia / Radiče úložísk“ existujú:

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

   Ak chýbajú, možno ich pridať manuálne cez hdwwiz.exe (radiče úložísk → Microsoft → Microsoft VHD Loopback Controller) a overte, že služba FsDepends nie je zakázaná.

4. Importovaný obraz nespĺňa požiadavky WSL: pri wsl --import --vhd musí byť VHDX v súborovom systéme ext4; nesmie to byť LUKS šifrovaný disk, bežný raw.img, Live ISO ani prázdny disk naformátovaný NTFS/FAT. .img / .qcow2 / .iso nemožno priamo použiť s wsl --import --vhd.

5. Problémy s cestou/oprávneniami/súborovým systémom: cieľový adresár musí byť na disku NTFS (FAT32/exFAT nefungujú); v ceste sa vyhnite čínskym znakom, medzerám a špeciálnym symbolom; neimportujte zo sieťových diskov, OneDrive alebo komprimovaných priečinkov; vždy používajte skutočný PowerShell správcu (nie bežný terminál).

6. Poškodenie systémových komponentov: postupne spustite DISM a SFC pre opravu systémových komponentov a potom to skúste znova:

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

TIP

Virtuálne stroje tretích strán (VirtualBox, VMware) alebo sandbox/posilňujúce funkcie bezpečnostného softvéru (napr. 360, Huorong) môžu narúšať operácie s virtuálnymi diskmi; pri riešení problémov ich možno dočasne vypnúť.