Dystrybucja nie uruchamia się po instalacji

Dystrybucja nie uruchamia się po instalacji (WSL) wskazuje na brakującą aktualizację jądra WSL2 — uruchamia się ją poleceniem wsl --update z uprawnieniami administratora.

Dystrybucja nie uruchamia się po instalacji — co oznacza ten problem

Komunikat lub sytuacja, w której dystrybucja Linuksa nie startuje po dodaniu jej do WSL, oznacza, że środowisko nie może poprawnie przejść od instalacji plików dystrybucji do uruchomienia jej w ramach podsystemu Windows. Sama obecność nazwy systemu na liście zainstalowanych dystrybucji nie potwierdza jeszcze, że środowisko wykonawcze działa prawidłowo. Do uruchomienia potrzebne są między innymi właściwe składniki WSL, zgodna wersja komponentów systemowych oraz działające jądro WSL2.

Najczęściej problem pojawia się po świeżej instalacji WSL, po większej aktualizacji Windows albo wtedy, gdy dystrybucja została przypisana do WSL2, lecz wymagany pakiet jądra nie został jeszcze pobrany lub zaktualizowany. W takiej sytuacji polecenie startowe może kończyć się komunikatem o braku jądra, niezgodnej wersji, niepoprawnej konfiguracji maszyny wirtualnej albo błędzie inicjalizacji środowiska.

Nie należy utożsamiać tego objawu z uszkodzeniem samej dystrybucji. Często pliki Ubuntu, Debiana lub innego systemu są zapisane poprawnie, lecz warstwa WSL nie ma aktualnego komponentu potrzebnego do ich uruchomienia. W pierwszej kolejności warto więc sprawdzić stan funkcji WSL i wersję używanego środowiska, zamiast od razu usuwać oraz instalować dystrybucję ponownie.

Rola jądra WSL2 i różnica między WSL1 a WSL2

WSL1 i WSL2 korzystają z odmiennego sposobu działania. WSL1 tłumaczy wywołania systemu Linux na mechanizmy dostępne w Windows, natomiast WSL2 uruchamia rzeczywiste jądro Linuksa w lekkim, zarządzanym środowisku wirtualnym. Dzięki temu WSL2 zapewnia szerszą zgodność z narzędziami linuksowymi, ale wymaga również dodatkowych elementów systemowych, w tym aktualnego pakietu jądra i poprawnie działającej platformy maszyn wirtualnych.

Jeżeli dystrybucja została ustawiona jako WSL2, a komponent jądra jest nieobecny lub nieaktualny, system może nie dojść do etapu otwarcia powłoki. Pomocne jest sprawdzenie konfiguracji poleceniem:

wsl --status

Można również wyświetlić zainstalowane dystrybucje wraz z przypisanym trybem pracy:

wsl --list --verbose

Gdy wynik wskazuje na WSL2, ale pojawia się informacja o brakującym jądrze lub wymaganej aktualizacji, należy wykonać aktualizację z okna PowerShell albo terminala uruchomionego z uprawnieniami administratora:

wsl --update

Po zakończeniu aktualizacji może być potrzebne ponowne uruchomienie WSL:

wsl --shutdown

Następnie można ponownie uruchomić wybraną dystrybucję, na przykład przez polecenie wsl albo przez jej nazwę widoczną na liście. Jeżeli używane wydanie Windows nie obsługuje wymaganej wersji WSL2, konieczne może być także doinstalowanie aktualizacji systemowych oraz włączenie funkcji „Podsystem Windows dla systemu Linux” i „Platforma maszyn wirtualnych”.

Typowe przyczyny i błędy po instalacji dystrybucji

Jedną z częstych przyczyn jest zatrzymana lub niepełna aktualizacja WSL. Instalator dystrybucji może zakończyć pracę, lecz właściwy komponent wykonawczy pozostaje w starszej wersji. Podobny efekt występuje po przywróceniu obrazu systemu, migracji na inny dysk albo zmianie ustawień funkcji wirtualizacji w firmware komputera.

Drugą grupę stanowią problemy z funkcjami Windows. WSL2 potrzebuje aktywnej platformy maszyn wirtualnych, dlatego wyłączenie wirtualizacji procesora, dezaktywowanie odpowiedniej funkcji systemowej lub nieukończona aktualizacja składników opcjonalnych może uniemożliwić start dystrybucji. Warto sprawdzić stan funkcji systemu Windows, uruchomić ponownie komputer po ich włączeniu i dopiero później ponowić próbę uruchomienia.

Możliwe są także błędy związane z konkretną dystrybucją. Uszkodzenie jej systemu plików, przerwanie pierwszej konfiguracji użytkownika, brak wolnego miejsca albo nieprawidłowe dane rejestracyjne mogą powodować zamknięcie procesu tuż po starcie. Jeżeli w dystrybucji przechowywane są ważne pliki, nie powinno się pochopnie wykonywać polecenia wsl --unregister, ponieważ usuwa ono zarejestrowane środowisko wraz z jego danymi.

W niektórych przypadkach problem wynika z konfliktu ustawień wersji. Można sprawdzić domyślną wersję poleceniem:

wsl --set-default-version 2

Zmiana ustawienia domyślnego nie konwertuje automatycznie każdej już zainstalowanej dystrybucji. Dla istniejącego środowiska stosuje się osobne polecenie, na przykład:

wsl --set-version NAZWA_DYSTRYBUCJI 2

W miejsce NAZWA_DYSTRYBUCJI należy wstawić dokładną nazwę odczytaną z listy WSL. Podczas konwersji nie powinno się zamykać terminala ani wyłączać komputera, ponieważ proces może wymagać czasu i wykorzystuje pliki wirtualnego dysku dystrybucji.

Kiedy warto umówić wizytę serwisową - Dystrybucja nie uruchamia się po instalacji

Do serwisu warto zgłosić się wtedy, gdy aktualizacja WSL nie rozwiązuje problemu, polecenia są odrzucane mimo uruchomienia terminala jako administrator albo dystrybucja uruchamia się i natychmiast zamyka. Szczególnej ostrożności wymaga sytuacja, w której środowisko zawiera projekty, konfiguracje, klucze lub inne dane, których nie można utracić. Przed usunięciem dystrybucji należy ustalić, czy możliwe jest wykonanie kopii zapasowej i eksportu.

Diagnostyka powinna objąć wersję Windows, stan składników WSL, tryb uruchamiania dystrybucji, dostępność wirtualizacji, komunikaty z terminala oraz ewentualne błędy aktualizacji. W Warszawskim Pogotowiu Komputerowym 24/7 można zlecić analizę takiego przypadku, gdy potrzebne jest uporządkowane sprawdzenie konfiguracji systemu i bezpieczne przywrócenie startu środowiska Linux w Windows.

Nie należy ograniczać się do samego ponownego instalowania dystrybucji, ponieważ przyczyna może znajdować się poza jej plikami. Jeżeli źródłem problemu jest brak jądra, nieaktywna funkcja systemowa, niespójność aktualizacji albo ustawienia wirtualizacji, ponowna instalacja może jedynie powtórzyć ten sam błąd. Najbezpieczniejsze postępowanie polega na zachowaniu danych, zebraniu pełnego komunikatu, sprawdzeniu stanu WSL i dopiero potem wykonaniu działań naprawczych.