Setup & Config WSL

Pred použitím aplikácie WSL Dashboard musí váš systém Windows správne povoliť a nakonfigurovať prostredie WSL 2. Táto dokumentácia sa skladá z troch hlavných častí:

1. Povolenie a konfigurácia WSL: základné kroky inštalácie a konfigurácie WSL 2.
2. Dostupnosť príkazov neznamená úspešnú inštaláciu: vysvetľuje, že spustiteľný príkaz wsl nezaručuje úspešnú inštaláciu systému Linux.
3. Riešenie problémov s inštaláciou: spôsoby kontroly a opravy, ak inštalácia po dokončení konfigurácie stále zlyháva.

1. Povolenie a konfigurácia WSL

Táto kapitola vás prevedie nevyhnutnými základnými nastaveniami. Po dokončení tejto kapitoly si prečítajte kapitolu 2, aby ste pochopili rozdiel medzi dostupnosťou príkazov 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 systému Windows. Stlačte Win + R, zadajte winver a skontrolujte svoju verziu:

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

IMPORTANT

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

1.2 Povolenie 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).

• Spôsob kontroly: otvorte "Správcu úloh" -> kartu "Výkon" -> "CPU".
• Kontrola stavu: overte, že stav "Virtualizácia" v pravom dolnom rohu ukazuje "Povolené".
• Spôsob povolenia: ak nie je povolená, 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 súvisiacich funkcií systému Windows

Musíte povoliť funkcie "Podsystém Windows pre Linux" a "Platforma virtuálnych počítačov".

Metóda A: Cez grafické rozhranie (odporúča sa)

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

Metóda B: Cez príkazový riadok (práva správcu)

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

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

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

Po vykonaní ručne reštartujte počítač.

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

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

• Adresa na stiahnutie: Microsoft Store — Windows Subsystem for Linux
• Manuálne stiahnutie: ak obchod nie je k dispozícii, môžete si stiahnuť najnovší inštalačný balík .msixbundle alebo .msi zo stránky WSL GitHub Releases na inštaláciu offline.

1.5 Nastavenie WSL 2 ako predvolenej verzie

Aby novonainštalované distribúcie v predvolenom nastavení používali WSL 2, spustite v termináli:

wsl --set-default-version 2

1.6 Časté problémy

• Chyba 0x80370102: zvyčajne je spôsobená tým, že v BIOS nie je povolená virtualizácia, alebo konfliktom s Hyper-V.
• Prepínanie medzi WSL 1 a WSL 2: môžete použiť príkaz wsl --set-version <názov distribúcie> 2 na upgrade existujúcej inštancie WSL 1 na WSL 2.

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

To, že príkazy wsl --version, wsl -l -v a podobné prebehnú bez chýb, neznamená, že podmienky na inštaláciu systému Linux sú už splnené. Ide o rôzne fázy, ktoré nemožno stotožňovať.

Dostupnosť príkazov vypovedá iba o tom, že:

• ✅ súčasti WSL v systéme Windows sú už 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

Ale na úspešnú inštaláciu distribúcie systému Linux sú potrebné ďalšie podmienky. Najčastejšie sa uviazne na nasledujúcom:

1. Virtualizácia je vypnutá: v BIOS/UEFI nie sú povolené VT-x / AMD-V, WSL 2 sa nespustí, alebo sa pri inštalácii distribúcie hlási chyba virtualizácie (spôsob kontroly — 1.2 Povolenie hardvérovej virtualizácie).
2. Príliš stará verzia/zostava systému Windows: WSL 2 má požiadavky na jadro a verziu; v edícii Home alebo príliš starých podnikových obrazoch môžu byť funkcie neúplné (spôsob kontroly — 1.1 Kontrola systémových požiadaviek).
3. Distribúcia systému Linux ešte nie je nainštalovaná: príkaz wsl -l -v vypíše iba nainštalované distribúcie; ak nie je nainštalované nič, zoznam bude prázdny, čo neznamená, že Ubuntu možno rovno spustiť.
4. Problémy so sieťou / Microsoft Store: príkaz wsl --install -d <distribúcia> potrebuje stiahnuť obraz z obchodu alebo zo siete; firemná sieť, proxy a brána firewall to môžu blokovať.
5. Nedostatočné oprávnenia: na inštaláciu distribúcie alebo zmenu nastavení WSL sú potrebné oprávnenia správcu.

TIP

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

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

Ak inštalácia po konfigurácii podľa kapitoly 1 (alebo keď si myslíte, že ste konfiguráciu dokončili) stále zlyháva príkazom wsl --install, postupujte v uvedenom poradí.

3.1 Najprv vykonajte "rýchlu kontrolu"

Spustite PowerShell ako správca a postupne spustite:

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

• ✅ Ak oba príkazy prebehnú bez problémov, voliteľné súčasti WSL sú povolené a podmienky virtualizácie sú v zásade splnené.
• ❌ Ak dôjde k chybe, systém rovno napovie, čo chýba (napr. platforma virtuálnych počítačov, Hyper-V, virtualizácia BIOS atď.).

Potom spustite systeminfo a vo výstupe overte, že sa objavuje Virtualization Enabled In Firmware: Yes. Ak vyššie uvedené prebehlo bez chýb, môžete bez obáv spustiť wsl --install na inštaláciu distribúcie.

NOTE

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

3.2 Ručný kontrolný zoznam

Ak "rýchla kontrola" problém nezistila, prejdite jednotlivé položky:

1. Skontrolujte, či je povolená virtualizácia BIOS/firmvéru: v PowerShelli ako správca spustite systeminfo; vo výstupe musí byť vidieť Virtualization Enabled In Firmware: Yes.
2. Skontrolujte, či sú povolené funkcie systému Windows:

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

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

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

Situácia	Popis	Spôsob riešenia
Virtualizácia nie je povolená v BIOS	Nevyhnutne skončí chybou	Reštartujte počítač, vstúpte do BIOS a povoľte VT-x / AMD-V (pozri 1.2)
Windows 10 nižší ako 19041	wsl --install nie je podporovaný	Aktualizujte systém (pozri 1.1)
Podnikové prostredie zakazuje Hyper-V / virtualizáciu	Možné zlyhanie	Obráťte sa na správcu systému
Stará edícia Home systému	Vyžaduje manuálnu inštaláciu	Manuálne nainštalujte jadro WSL podľa 1.4

3.4 Chyba 0xc03a0014: nedá sa nájsť poskytovateľ podpory virtuálneho disku

Chybové hlásenie: Cannot find a virtual disk support provider for the specified file. Problém nie je v samotnej distribúcii systému Linux, ale v tom, že zásobník virtuálnych diskov VHD/VHDX v systéme Windows nepracuje správne, kvôli čomu WSL 2 nemôže zaregistrovať distribúciu a vytvoriť/pripojiť ext4.vhdx.

Najprv vykonajte minimálne overenie: spustite PowerShell ako správca a vyskúšajte 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 systému Windows a nesúvisí s distribúciou.

Postupujte v tomto poradí:

1. Služba Virtual Disk nebeží: otvorte services.msc, nájdite službu Virtual Disk, nastavte typ spustenia 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 súvisiacich funkcií systému Windows a potom musíte reštartovať. Edícia Home systému Windows nemá plný Hyper-V, ale WSL 2 potrebuje iba platformu virtuálnych počítačov, nie konzolu správy Hyper-V.

3. Chýbajú ovládače/zariadenia virtuálnych diskov: otvorte Správcu zariadení a skontrolujte, či v sekcii "Systémové zariadenia / Radiče úložiska" existujú:

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

   Ak chýbajú, možno ich pridať ručne cez hdwwiz.exe (Radiče úložiska → Microsoft → Microsoft VHD Loopback Controller) a uistite sa, že služba FsDepends nie je zakázaná.

4. Importovaný obraz nezodpovedá požiadavkám WSL: pri použití wsl --import --vhd musí mať súbor VHDX súborový systém ext4; nevyhovujú šifrované disky LUKS, bežné raw.img, Live ISO ani prázdne disky naformátované na NTFS/FAT. Súbory .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 nie sú vhodné); v ceste sa vyhnite diakritike, medzerám a špeciálnym znakom; neimportujte zo sieťových diskov, OneDrive ani komprimovaných priečinkov; vždy používajte skutočný PowerShell spustený ako správca (nie bežný terminál).

6. Poškodené systémové súčasti: postupne spustite DISM a SFC na opravu systémových súčastí 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 funkcie sandboxu/posilnenia bezpečnostného softvéru (napr. 360, Huorong) môžu narúšať operácie s virtuálnymi diskmi; pri diagnostike ich môžete dočasne vypnúť a skúsiť to znova.