linux bejegyzés

WSL telepítése Windowson: parancsok és előfeltételek

A WSL telepítése Windows 10 és 11 alatt egyetlen paranccsal elvégezhető. A Microsoft dokumentációja szerint a Windows Subsystem for Linux Linux-környezetet ad a Windows mellé. Ez a cikk a hivatalos útmutató alapján mutatja be az előfeltételeket, a parancsokat és a legfontosabb beállításokat. Megtudod azt is, hogyan választasz másik Linux-disztribúciót.

  • Előfeltétel: Windows 10 2004-es verzió (Build 19041) vagy újabb, illetve Windows 11.
  • A telepítés parancsa a wsl –install, rendszergazdai PowerShellben.
  • Alapértelmezés szerint Ubuntu települ, az új telepítések WSL 2-t használnak.
  • Másik disztribúciót a -d kapcsolóval választhatsz.
  • A grafikus Linux-alkalmazásokhoz WSL 2 és újabb Windows-build kell.

 

Mi a WSL, és mire jó?

A WSL a Windows Subsystem for Linux rövidítése, vagyis Linux-környezet a Windows alatt. A Microsoft dokumentációja szerint a WSL telepítéséhez egyetlen parancs elég, amely a szükséges komponenseket is feltelepíti. Alapértelmezés szerint Ubuntu települ, és az új telepítések WSL 2-t használnak. Így Linux-parancsokat futtathatsz a Windows mellett, külön gép nélkül.

A WSL-ben több Linux-disztribúciót is használhatsz egymás mellett. Az elérhetőket a wsl –list –online paranccsal kérdezheted le. Ezt a későbbi szakaszok mutatják be. A fájlokat a Windows és a Linux között is elérheted, bár ez lassíthat.

Tipikus hiba, hogy valaki a WSL-ben azonnal teljes Linux asztalt keres. A grafikus Linux-alkalmazások futtatása külön követelményekkel jár. Teljes, különálló asztali rendszerhez a VirtualBox útmutató segít.

 

Milyen előfeltételei vannak a WSL telepítésének?

A wsl –install parancs Windows 10 2004-es verziójától (Build 19041) vagy Windows 11-től használható. Ennél régebbi rendszeren kézi telepítés kell. A parancsot rendszergazdai PowerShellben futtatod, utána újra kell indítanod a gépet. A grafikus Linux-alkalmazásokhoz újabb build és WSL 2 szükséges.

Utolsó frissítés: 2026-11-01
Követelmény Érték Megjegyzés
Windows 10 2004-es verzió (Build 19041) vagy újabb A wsl –install parancshoz
Windows 11 Támogatott A wsl –install parancshoz
Régebbi Windows Kézi telepítés A Microsoft külön oldala írja le
Parancssor Rendszergazdai PowerShell A telepítés után újraindítás kell
Grafikus alkalmazások Windows 10 Build 19044+ vagy Windows 11 Csak WSL 2-vel működnek

Az előfeltételek ellenőrzése a telepítés előtt időt takarít meg. Ha a Windows 10 verziód régebbi, előbb frissítened kell. Ha az átállás is érdekel, olvasd el az átállási cikket.

 

Hogyan zajlik a WSL telepítése lépésről lépésre?

A WSL telepítése egyetlen paranccsal indul, amelyet rendszergazdai PowerShellben vagy parancssorban futtatsz. A parancs telepíti a WSL-t és az alapértelmezett Ubuntu disztribúciót. Ezután újra kell indítanod a gépet. A dokumentáció szerint az újonnan telepített példány WSL 2-ként jön létre, külön beállítás nélkül.

Telepítés az alapértelmezett Ubuntu disztribúcióval, majd újraindítás:

wsl --install

A telepítés lépései röviden:

  1. Nyiss rendszergazdai PowerShellt.
  2. Futtasd a wsl –install parancsot.
  3. Indítsd újra a gépet.
  4. Ellenőrizd a telepítést a wsl –list –verbose paranccsal.

Ha a parancs a súgót írja ki a telepítés helyett, a WSL már telepítve van. Ilyenkor futtasd a wsl –list –online parancsot, majd a wsl –install -d paranccsal telepítsd a kívánt disztribúciót. A dokumentáció szerint a wsl –install csak akkor működik, ha a WSL még egyáltalán nincs telepítve.

Ha a telepítés a 0.0%-nál megakad, használd a web-letöltést:

wsl --install --web-download -d <DistroName>

Tipikus hiba, hogy valaki újraindítás nélkül próbálja használni az új rendszert. A dokumentáció a telepítés után újraindítást ír elő. Régi Windows-buildnél a parancs nem működik, ilyenkor kézi telepítés kell.

 

Hogyan választasz másik Linux-disztribúciót?

Az alapértelmezett Ubuntu helyett másik disztribúciót is telepíthetsz a -d kapcsolóval. Először kérdezd le az online elérhető listát. Ezután a wsl –install paranccsal és a disztribúció nevével telepítsd. A névnek pontosan egyeznie kell a listában szereplő névvel, különben a telepítés hibát jelez.

A lista lekérdezése és a kiválasztott disztribúció telepítése:

wsl --list --online
wsl --install -d <DistroName>

Egyszerre több disztribúciót is telepíthetsz, és külön kezelheted őket. A wsl –set-default paranccsal állíthatod be az alapértelmezettet. A telepített példányokat a wsl –list –verbose paranccsal listázhatod.

Tipikus hiba, hogy valaki a disztribúció nevét nem pontosan írja be. Ilyenkor a telepítés hibát jelez. Mindig a wsl –list –online kimenetéből másold ki a nevet. A parancsokhoz a Linux parancsok kezdőknek cikk is segít.

 

Melyik verziót használd, az 1-est vagy a 2-est?

A WSL 2 az újonnan telepített disztribúciók alapértelmezett verziója. A dokumentáció szerint a grafikus Linux-alkalmazások csak WSL 2-vel működnek. A verziót minden telepített disztribúciónál külön is módosíthatod. Az új telepítések alapértelmezett verzióját külön parancs állítja be, amelyet az alábbi parancsok között találsz.

A verziók lekérdezése, az alapértelmezés beállítása és egy disztribúció átállítása:

wsl --list --verbose
wsl --set-default-version 2
wsl --set-version Ubuntu 2

Tipikus hiba, hogy valaki WSL 1-es disztribúcióval próbál grafikus alkalmazást futtatni. Ez nem működik, mert a grafikus alkalmazások csak WSL 2-vel támogatottak. Ellenőrizd a verziót a wsl –list –verbose paranccsal, és szükség esetén állítsd át.

A grafikus alkalmazásokhoz Windows 10 Build 19044 vagy újabb, illetve Windows 11 kell. A videokártya-illesztőt is érdemes telepítened a hardveres gyorsításhoz. Frissítésnél a wsl –update és a wsl –shutdown parancs való, utána a GIMP például az apt-tal telepíthető.

Frissítés PowerShellben, majd a GIMP telepítése és indítása a Linux-parancssorban:

wsl --update
wsl --shutdown
sudo apt update
sudo apt install gimp -y
gimp

 

Melyik parancsokat érdemes ismerned?

A WSL telepítése után a Microsoft dokumentációja sorolja fel az alapvető parancsokat. Egy Linux-parancssorból a wsl helyett a wsl.exe nevet kell használnod. A legfontosabbak a lista, a leállítás, az alapértelmezett beállítása és az eltávolítás. Az export és az import a példányok mentésére és áthelyezésére való.

Az alapvető parancsok és a céljuk:

  • wsl –list –verbose: a telepített disztribúciók, az állapotuk és a verziójuk.
  • wsl –list –online: az online elérhető disztribúciók listája.
  • wsl –shutdown: minden futó disztribúció és a WSL 2 könnyű virtuális gépének leállítása.
  • wsl –terminate <név>: egy disztribúció leállítása.
  • wsl –set-default <név>: az alapértelmezett disztribúció beállítása.
  • wsl –update: a WSL frissítése a legújabb verzióra.
  • wsl –status: az általános beállítások, az alapértelmezett disztribúció és a kernelverzió.

Az export alapból tar fájlba ment, WSL 2-nél VHD-ba is. Az import megadja az új nevet és a telepítési helyet. Az update parancs a –web-download kapcsolóval a GitHubról tölt, nem a Microsoft Store-ból.

Tipikus hiba, hogy valaki a wsl –unregister paranccsal próbál csak leállítani egy disztribúciót. A parancs a disztribúció minden adatát, beállítását és szoftverét véglegesen törli. Leállításhoz a –terminate kapcsoló való. Mentéshez használd előbb a wsl –export parancsot.

 

Hogyan dolgozz kényelmesen a WSL-ben?

A Microsoft a Windows Terminal használatát ajánlja, különösen több parancssor esetén. A fájlokat ugyanazon az operációs rendszeren tárold, ahol az eszközeid futnak. Linux-eszközökhöz a WSL fájlrendszere a leggyorsabb. A Visual Studio Code a WSL-bővítménnyel közvetlenül támogatja a távoli fejlesztést és a hibakeresést.

Az aktuális mappa megnyitása a Windows Intézőben, majd a projekt megnyitása a VS Code-dal:

explorer.exe .
code .

A Windows-fájlrendszerből, például a /mnt/c alól Linux-eszközökkel dolgozni a dokumentáció szerint jelentősen lassíthat. A projektet ezért a Linux-fájlrendszer saját könyvtárában érdemes tartanod. A dokumentáció a Docker távoli konténereket is említi a WSL 2-höz. Ehhez a Docker telepítése Ubuntun cikk ad alapot.

Tipikus hiba, hogy valaki a projektet a Windows-mappában tárolja, miközben Linux-eszközökkel dolgozik. Ilyenkor a teljesítmény romolhat. Az alapértelmezett Ubunturól a Mi az Ubuntu? cikk ír.

 

Gyakran ismételt kérdések

Mi az a WSL röviden?

A Windows Subsystem for Linux rövidítése. Linux-környezetet ad a Windows mellé, külön gép nélkül. A telepítés egyetlen paranccsal elvégezhető. Alapértelmezés szerint Ubuntu települ.

 

Hogyan indul a WSL telepítése?

Rendszergazdai PowerShellben futtasd a wsl –install parancsot. A parancs telepíti a WSL-t és az alapértelmezett Ubuntut. Ezután újra kell indítanod a gépet. Az újonnan telepített példány WSL 2-ként jön létre.

 

Melyik Windows-verzió kell hozzá?

A wsl –install parancshoz Windows 10 2004-es verzió (Build 19041) vagy újabb kell. Windows 11-en is használható. Régebbi rendszeren kézi telepítés szükséges. A grafikus alkalmazásokhoz Windows 10 Build 19044 vagy Windows 11 kell.

 

Melyik disztribúció települ alapból?

Alapértelmezés szerint az Ubuntu. Másikat a -d kapcsolóval választhatsz. Az elérhető disztribúciókat a wsl –list –online paranccsal kérdezheted le. A nevet pontosan a listából másold ki.

 

Mit tegyek, ha a telepítés megakad?

Ha a telepítés a 0.0%-nál leáll, használd a –web-download kapcsolót. A parancs: wsl –install –web-download -d és a disztribúció neve. Ha a súgó jelenik meg, a WSL már telepítve van. Ilyenkor a wsl –list –online paranccsal listázz, és a -d kapcsolóval telepíts.

 

Hogyan váltok WSL 2-re?

A wsl –set-version paranccsal a disztribúció nevét és a verziót adod meg. Például: wsl –set-version Ubuntu 2. Az új telepítések alapértelmezett verzióját a wsl –set-default-version paranccsal állíthatod. A jelenlegi verziót a wsl –list –verbose mutatja.

 

Futtathatok grafikus alkalmazást?

Igen, ha Windows 10 Build 19044 vagy újabb, illetve Windows 11 fut a gépen. A disztribúciónak WSL 2 verziójúnak kell lennie. Érdemes telepíteni a videokártya-illesztőt is. Az alkalmazásokat a Linux-parancssorban az apt-tal telepítheted.

 

Mit töröl a wsl –unregister parancs?

A disztribúció minden adatát, beállítását és szoftverét véglegesen törli. Ezt a dokumentáció külön figyelmeztetésként emeli ki. Leállításhoz a wsl –terminate parancs való. Mentéshez használd előbb az export parancsot.

Szerző: a Linuxinfok szerkesztősége. Utolsó frissítés: 2026-11-01. A parancsok a hivatalos dokumentáció alapján készültek, futtatás előtt ellenőrizd az aktuális oldalt.

 

Források és referenciák