WSL सेटप

WSL Dashboard वापरण्यापूर्वी, तुमच्या Windows सिस्टमवर WSL 2 वातावरण योग्यरित्या सक्षम आणि कॉन्फिगर केलेले असणे आवश्यक आहे. हा दस्तऐवज खालील तीन मुख्य भागांमध्ये विभागलेला आहे:

1. WSL सक्षम करा आणि कॉन्फिगर करा: WSL 2 ची मूलभूत स्थापना आणि कॉन्फिगरेशन पूर्ण करा.
2. कमांड उपलब्ध असणे म्हणजे स्थापना यशस्वी होणे नव्हे: स्पष्ट करते की wsl कमांड चालणे म्हणजे Linux यशस्वीरित्या स्थापित करता येईल असे नाही.
3. स्थापना अपयशाचे निवारण: कॉन्फिगरेशन पूर्ण झाल्यानंतरही स्थापना अपयशी ठरल्यास तपासणी आणि दुरुस्तीच्या पद्धती.

1. WSL सक्षम करा आणि कॉन्फिगर करा

हा अध्याय तुम्हाला आवश्यक मूलभूत सेटअप पूर्ण करण्यास मार्गदर्शन करेल. हा अध्याय पूर्ण केल्यानंतर, कमांड उपलब्ध असणे आणि स्थापना यशस्वी होणे यातील फरक समजून घेण्यासाठी अध्याय 2 वाचा; स्थापनेत अजूनही समस्या आल्यास अध्याय 3 पहा.

1.1 सिस्टम आवश्यकता तपासा

WSL 2 साठी Windows आवृत्तीच्या किमान आवश्यकता आहेत. तुमची आवृत्ती तपासण्यासाठी Win + R दाबा आणि winver टाइप करा:

• Windows 10: आवृत्ती 1903 किंवा त्यापेक्षा नवीन, आणि बिल्ड (Build) 18362 किंवा त्यापेक्षा अधिक असणे आवश्यक.
• Windows 11: सर्व आवृत्त्या समर्थित.

IMPORTANT

तुमची आवृत्ती खूप जुनी असल्यास, प्रथम "Windows Update" द्वारे तुमची सिस्टम अपग्रेड करा.

1.2 हार्डवेअर व्हर्च्युअलायझेशन सक्षम करा

WSL 2 व्हर्च्युअलायझेशन तंत्रज्ञानावर चालते, त्यामुळे मदरबोर्डच्या BIOS/UEFI मध्ये व्हर्च्युअलायझेशन तंत्रज्ञान (Virtualization Technology) सक्षम असणे आवश्यक आहे.

• तपासणीची पद्धत: "टास्क मॅनेजर" उघडा -> "कार्यक्षमता" टॅब -> "CPU".
• स्थिती पहा: उजवीकडे खाली "व्हर्च्युअलायझेशन" ची स्थिती "सक्षम" दिसते याची खात्री करा.
• सक्षम करण्याची पद्धत: सक्षम नसल्यास, तुम्हाला संगणक रीस्टार्ट करून BIOS/UEFI सेटिंग्जमध्ये जावे लागेल, Intel VT-x किंवा AMD-V सारखा पर्याय शोधून तो Enabled वर सेट करावा लागेल.

1.3 Windows-संबंधित वैशिष्ट्ये सक्षम करा

तुम्हाला Windows ची "Windows Subsystem for Linux" आणि "Virtual Machine Platform" ही वैशिष्ट्ये सक्षम करावी लागतील.

पद्धत A: ग्राफिकल इंटरफेसद्वारे (शिफारसीय)

1. Win + S दाबा, "Windows वैशिष्ट्ये चालू किंवा बंद करा" शोधा आणि उघडा.
2. खालील दोन पर्यायांवर टिक करा:
   • Windows Subsystem for Linux
   • Virtual Machine Platform
3. "ठीक आहे" क्लिक करा आणि सूचना दिल्यावर संगणक रीस्टार्ट करा.

पद्धत B: कमांड लाइनद्वारे (प्रशासक परवानग्या)

PowerShell प्रशासक म्हणून चालवा आणि खालील कमांड्स कार्यान्वित करा:

# WSL सक्षम करा
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

# व्हर्च्युअल मशीन प्लॅटफॉर्म सक्षम करा
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

कार्यान्वित केल्यानंतर, कृपया व्यक्तिचलितपणे संगणक रीस्टार्ट करा.

1.4 WSL कर्नल स्थापित किंवा अपडेट करा

आधुनिक Windows आवृत्त्या Microsoft Store द्वारे WSL अपडेट्स मिळवू शकतात.

• डाउनलोड पत्ता: Microsoft Store - Windows Subsystem for Linux
• व्यक्तिचलित डाउनलोड: स्टोअर वापरता येत नसल्यास, WSL GitHub Releases वरून नवीनतम .msixbundle किंवा .msi स्थापना पॅकेज डाउनलोड करून ऑफलाइन स्थापना करू शकता.

1.5 WSL 2 डिफॉल्ट आवृत्ती म्हणून सेट करा

नव्याने स्थापित केलेल्या डिस्ट्रिब्युशन्सनी डिफॉल्टनुसार WSL 2 वापरावे याची खात्री करण्यासाठी, टर्मिनलमध्ये कार्यान्वित करा:

wsl --set-default-version 2

1.6 सामान्य समस्या

• एरर 0x80370102: सामान्यतः BIOS मध्ये व्हर्च्युअलायझेशन सक्षम नसल्यामुळे, किंवा Hyper-V शी संघर्ष झाल्यामुळे होतो.
• WSL 1 आणि WSL 2 मध्ये स्विच करणे: तुम्ही wsl --set-version <डिस्ट्रिब्युशनचे नाव> 2 वापरून विद्यमान WSL 1 इन्स्टन्स WSL 2 मध्ये अपग्रेड करू शकता.

2. कमांड उपलब्ध असणे म्हणजे स्थापना यशस्वी होणे नव्हे

wsl --version, wsl -l -v यांसारख्या कमांड्सचे योग्यरित्या चालणे, म्हणजे Linux स्थापित करण्याच्या अटी पूर्ण झाल्या आहेत असे अजिबात नाही. हे दोन वेगळे टप्पे आहेत, त्यांना समान मानता येणार नाही.

कमांड उपलब्ध असणे फक्त हे दर्शवते:

• ✅ Windows मध्ये WSL घटक सक्षम/स्थापित झाले आहेत
• ✅ wsl.exe कमांड-लाइन टूल उपलब्ध आहे
• ✅ सिस्टम WSL-संबंधित कमांड्स ओळखू शकते

परंतु Linux डिस्ट्रिब्युशन यशस्वीरित्या स्थापित करण्यासाठी अतिरिक्त अटी पूर्ण कराव्या लागतात. सामान्यतः जिथे अडकते:

1. व्हर्च्युअलायझेशन बंद आहे: BIOS/UEFI मध्ये VT-x / AMD-V सक्षम नाही, WSL 2 सुरू होऊ शकत नाही, किंवा डिस्ट्रिब्युशन स्थापित करताना व्हर्च्युअलायझेशन एरर दिसते (तपासणीच्या पद्धतीसाठी 1.2 हार्डवेअर व्हर्च्युअलायझेशन सक्षम करा पहा).
2. Windows आवृत्ती/बिल्ड खूप जुनी आहे: WSL 2 साठी कर्नल आणि आवृत्तीच्या आवश्यकता आहेत; होम आवृत्ती, खूप जुन्या एंटरप्राइझ इमेजमध्ये वैशिष्ट्ये अपूर्ण असू शकतात (तपासणीच्या पद्धतीसाठी 1.1 सिस्टम आवश्यकता तपासा पहा).
3. प्रत्यक्षात कोणतेही Linux डिस्ट्रिब्युशन स्थापित केलेले नाही: wsl -l -v फक्त स्थापित केलेल्या डिस्ट्रिब्युशन्सची यादी दाखवते; काहीही स्थापित नसल्यास यादी रिकामी असते, याचा अर्थ Ubuntu थेट चालवता येईल असे नाही.
4. नेटवर्क / Microsoft Store समस्या: wsl --install -d <डिस्ट्रिब्युशन> साठी स्टोअर किंवा नेटवर्कवरून इमेज खेचावी लागते; कंपनी नेटवर्क, प्रॉक्सी, फायरवॉल ते रोखू शकतात.
5. अपुरी परवानगी: डिस्ट्रिब्युशन स्थापित करण्यासाठी किंवा WSL सेटिंग्ज बदलण्यासाठी प्रशासक परवानगी आवश्यक आहे.

TIP

सोप्या शब्दांत: WSL कमांड चालणे ≠ Linux तयार आहे, फक्त "प्रवेश तिकीट" मिळाले आहे, सिस्टम अजून प्रत्यक्षात स्थापित झालेली नाही.

3. स्थापना अपयशाचे निवारण करा

अध्याय 1 नुसार कॉन्फिगरेशन पूर्ण केल्यानंतर (किंवा तुम्हाला कॉन्फिगरेशन पूर्ण झाले आहे असे वाटत असल्यास), तरीही wsl --install अपयशी ठरत असेल, तर खालील क्रमाने तपासा.

3.1 प्रथम "एक-क्लिक तपासणी" करा

PowerShell प्रशासक म्हणून चालवा आणि क्रमाने कार्यान्वित करा:

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

• ✅ या दोन्ही कमांड्स सुरळीतपणे चालल्यास, WSL पर्यायी घटक सक्षम आहेत आणि व्हर्च्युअलायझेशनच्या अटी मुळात पूर्ण झाल्या आहेत.
• ❌ अपयशी ठरल्यास, थेट सांगेल की काय कमी आहे (जसे व्हर्च्युअल मशीन प्लॅटफॉर्म, Hyper-V, BIOS व्हर्च्युअलायझेशन इ.).

नंतर systeminfo चालवा आणि आउटपुटमध्ये Virtualization Enabled In Firmware: Yes दिसते याची खात्री करा. वरील सर्वांमध्ये कोणतीही एरर नसल्यास, मुळात निश्चिंत होऊन wsl --install ने डिस्ट्रिब्युशन स्थापित करता येईल.

NOTE

कोणतीही कमांड 100% हमी देऊ शकत नाही की wsl --install निश्चितपणे यशस्वी होईल, परंतु वरील तपासण्या स्थापनेच्या अटी पूर्ण झाल्या आहेत की नाही याची खात्री करू शकतात.

3.2 व्यक्तिचलित तपासणी यादी

"एक-क्लिक तपासणी" ने समस्या शोधता आली नाही, तर एकेक करून तपासा:

1. BIOS/फर्मवेअर व्हर्च्युअलायझेशन चालू आहे का तपासा: प्रशासक PowerShell मध्ये systeminfo चालवा, आउटपुटमध्ये Virtualization Enabled In Firmware: Yes दिसणे आवश्यक आहे.
2. Windows वैशिष्ट्ये चालू आहेत का तपासा:

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

   दोन्ही कमांड्सची स्थिती Enabled असणे आवश्यक आहे.
3. WSL उपलब्ध आहे का तपासा: wsl --version चालवल्यास सामान्य आउटपुट यायला हवे; कमांड सापडली नाही असे सांगितल्यास, WSL घटक स्थापित नाहीत, कृपया अध्याय 1 वर परत जा.
4. WSL 2 वापरता येते का तपासा (कर्नल आणि व्हर्च्युअल मशीन प्लॅटफॉर्म): wsl --set-default-version 2 चालवल्यास यशस्वीरित्या परत यायला हवे. सामान्य अपयशाची कारणे: व्हर्च्युअल मशीन प्लॅटफॉर्म सक्षम नसणे, किंवा BIOS मध्ये VT-x / AMD-V चालू नसणे.

3.3 सामान्य अपयश कारणांची द्रुत तपासणी

स्थिती	स्पष्टीकरण	उपाय
BIOS मध्ये व्हर्च्युअलायझेशन चालू नाही	निश्चितपणे अपयश	रीस्टार्ट करून BIOS मध्ये VT-x / AMD-V चालू करा (पहा 1.2)
Windows 10, 19041 पेक्षा कमी	wsl --install समर्थित नाही	सिस्टम अपग्रेड करा (पहा 1.1)
एंटरप्राइझ वातावरणात Hyper-V / व्हर्च्युअलायझेशन अक्षम	संभवतः अपयश	सिस्टम प्रशासकाशी संपर्क साधा
जुनी होम आवृत्ती सिस्टम	व्यक्तिचलित स्थापना आवश्यक	1.4 नुसार WSL कर्नल व्यक्तिचलितपणे स्थापित करा

3.4 एरर 0xc03a0014: व्हर्च्युअल डिस्क समर्थन प्रदाता सापडला नाही

एरर संदेश: Cannot find a virtual disk support provider for the specified file. ही Linux डिस्ट्रिब्युशनची समस्या नाही, तर Windows चा VHD/VHDX व्हर्च्युअल डिस्क स्टॅक व्यवस्थित कार्य करत नाही, WSL 2 डिस्ट्रिब्युशन नोंदणी करताना आणि ext4.vhdx तयार/माउंट करताना अपयशी ठरते.

आधी किमान तपासणी करा: PowerShell प्रशासक म्हणून चालवून New-VHD चाचणी करा (उदाहरण: New-VHD -Path C:\test.vhdx -SizeBytes 1GB). ही कमांड देखील तीच एरर दर्शवत असल्यास, समस्या 100% Windows च्या बाजूने आहे, डिस्ट्रिब्युशनशी संबंधित नाही.

खालील क्रमाने तपासून दुरुस्ती करा:

1. Virtual Disk सेवा चालू नाही: services.msc उघडा, Virtual Disk सेवा शोधा, स्टार्टअप प्रकार "स्वयंचलित" (Automatic) करा आणि ती सुरू करा.

2. WSL / व्हर्च्युअल मशीन प्लॅटफॉर्म वैशिष्ट्ये सक्षम नाहीत (किंवा प्रभावी नाहीत): 1.3 Windows-संबंधित वैशिष्ट्ये सक्षम करा मधील कमांड्स पुन्हा चालवा, नंतर रीस्टार्ट करणे अनिवार्य आहे. Windows होम आवृत्तीत पूर्ण Hyper-V नसते, परंतु WSL 2 साठी फक्त व्हर्च्युअल मशीन प्लॅटफॉर्म आवश्यक आहे, Hyper-V व्यवस्थापन इंटरफेस नाही.

3. व्हर्च्युअल डिस्क ड्रायव्हर/डिव्हाइस अनुपस्थित: डिव्हाइस मॅनेजर उघडा, "सिस्टम डिव्हाइस / स्टोरेज कंट्रोलर" मध्ये खालील गोष्टींची उपस्थिती तपासा:

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

   अनुपस्थित असल्यास hdwwiz.exe द्वारे व्यक्तिचलितपणे जोडू शकता (स्टोरेज कंट्रोलर → Microsoft → Microsoft VHD लूपबॅक कंट्रोलर), आणि FsDepends सेवा अक्षम नाही याची खात्री करा.

4. आयात केलेली इमेज WSL आवश्यकता पूर्ण करत नाही: wsl --import --vhd वापरताना, VHDX ext4 फाइल सिस्टम असणे आवश्यक आहे; LUKS एन्क्रिप्टेड डिस्क, सामान्य raw.img, Live ISO किंवा NTFS/FAT ने फॉरमॅट केलेली रिकामी डिस्क असता कामा नये. .img / .qcow2 / .iso थेट wsl --import --vhd ने चालवता येत नाहीत.

5. पाथ/परवानगी/फाइल सिस्टम समस्या: लक्ष्य निर्देशिका NTFS डिस्कवर असणे आवश्यक आहे (FAT32/exFAT चालणार नाही); पाथमध्ये चिनी अक्षरे, स्पेस आणि विशेष चिन्हे टाळा; नेटवर्क ड्राइव्ह, OneDrive, कॉम्प्रेस्ड फोल्डरमधून आयात करू नका; निश्चितपणे खऱ्या प्रशासक PowerShell चा वापर करा (सामान्य टर्मिनल नाही).

6. सिस्टम घटक खराब: क्रमाने DISM आणि SFC चालवून सिस्टम घटक दुरुस्त करा, नंतर पुन्हा प्रयत्न करा:

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

TIP

तृतीय-पक्ष व्हर्च्युअल मशिन्स (VirtualBox, VMware) किंवा सुरक्षा सॉफ्टवेअरची सँडबॉक्स/हार्डनिंग वैशिष्ट्ये (जसे 360, हुओरोंग) व्हर्च्युअल डिस्क ऑपरेशनमध्ये अडथळा आणू शकतात; समस्या शोधताना ती तात्पुरती बंद करून पुन्हा प्रयत्न करा.