Instalacja dystrybucji kończy się błędem

Instalacja dystrybucji kończy się błędem (WSL) wskazuje na brakującą aktualizację jądra Linux dla WSL2 — uruchamia się ją poleceniem wsl --update.

Co oznacza komunikat „Instalacja dystrybucji kończy się błędem”

Komunikat „Instalacja dystrybucji kończy się błędem” pojawia się najczęściej podczas dodawania systemu Linux do środowiska Windows Subsystem for Linux, czyli WSL. Oznacza to, że proces pobierania lub uruchamiania wybranej dystrybucji, takiej jak Ubuntu, Debian albo inny zgodny system, nie może zostać poprawnie zakończony. Sam komunikat jest ogólny i nie wskazuje jednej, zawsze identycznej przyczyny.

W przypadku WSL2 dystrybucja nie działa wyłącznie jako zestaw plików zapisanych na dysku. Do uruchomienia potrzebne jest również odpowiednie środowisko jądra Linux oraz włączone składniki systemu Windows. Jeżeli brakuje aktualizacji jądra, wymagane komponenty są nieaktywne albo system został zaktualizowany tylko częściowo, instalator może przerwać działanie przed pierwszym uruchomieniem dystrybucji.

Warto odróżnić błąd instalacji dystrybucji od problemu z samym systemem Linux. Jeżeli pobieranie zostało zakończone, lecz nie dochodzi do utworzenia konta użytkownika lub otwarcia powłoki, przyczyna może leżeć w konfiguracji WSL, ustawieniach funkcji systemowych, uszkodzonym pakiecie albo niezgodności pomiędzy zainstalowanymi składnikami.

Jak wygląda zależność między WSL1 i WSL2

WSL może działać w dwóch podstawowych trybach. WSL1 korzysta z warstwy zgodności pozwalającej uruchamiać narzędzia Linux bez pełnego jądra Linux, natomiast WSL2 wykorzystuje rzeczywiste jądro Linux dostarczane i aktualizowane dla środowiska WSL. Z tego powodu WSL2 zapewnia szerszą zgodność z programami i poleceniami systemowymi, ale wymaga poprawnie działających dodatkowych komponentów.

Przy diagnozowaniu problemu należy sprawdzić, jaki tryb został przypisany instalowanej dystrybucji oraz czy jest dostępna wymagana wersja WSL. Podstawowe informacje można wyświetlić poleceniem:

wsl --status

Lista zainstalowanych dystrybucji wraz z używanym trybem jest dostępna po wykonaniu:

wsl --list --verbose

Jeżeli jako domyślna wersja ustawiono WSL2, a komputer nie ma aktualnego pakietu jądra, instalacja może kończyć się błędem mimo prawidłowego połączenia z internetem i wystarczającej ilości wolnego miejsca. W takiej sytuacji należy zaktualizować składniki WSL poleceniem:

wsl --update

Po zakończeniu aktualizacji może być potrzebne ponowne uruchomienie systemu. Dopiero później warto ponowić instalację dystrybucji, ponieważ wcześniejsze próby mogą pozostawić niepełny wpis lub częściowo pobrane dane.

Typowe przyczyny przerwania instalacji - Instalacja dystrybucji kończy się błędem

Jedną z częstszych przyczyn jest nieaktualne jądro Linux dla WSL2. Problem może wystąpić po świeżej instalacji Windows, po większej aktualizacji systemu albo po przywróceniu obrazu, w którym nie zachowano wszystkich elementów środowiska WSL. Wykonanie wsl --update pozwala pobrać nowsze składniki, o ile system ma dostęp do odpowiedniego źródła aktualizacji.

Drugą grupę przyczyn stanowią wyłączone funkcje systemowe. W zależności od używanego trybu konieczne może być włączenie obsługi Podsystemu Windows dla systemu Linux oraz platformy maszyny wirtualnej. Zmiany tych ustawień zwykle wymagają uprawnień administratora i ponownego uruchomienia komputera. Samo polecenie instalacji dystrybucji nie zawsze włączy wszystkie wymagane funkcje automatycznie.

Przerwanie procesu może być także związane z:

• uszkodzonym magazynem składników systemu Windows,
• niepełną aktualizacją systemu lub oczekującym ponownym uruchomieniem,
• ograniczeniami konta użytkownika albo brakiem uprawnień administratora,
• blokadą pobierania pakietu przez zaporę lub oprogramowanie ochronne,
• brakiem wolnego miejsca na partycji systemowej,
• pozostałościami po wcześniejszej, nieudanej instalacji dystrybucji,
• błędem aplikacji Microsoft Store lub mechanizmu pobierania pakietów,
• niezgodnością wersji systemu Windows z wymaganiami aktualnego wydania WSL.

Przed usunięciem dystrybucji należy sprawdzić, czy nie znajdują się w niej potrzebne pliki. Polecenie wsl --unregister usuwa zarejestrowaną dystrybucję wraz z jej środowiskiem, dlatego nie powinno być stosowane bez upewnienia się, że dane zostały skopiowane. W pierwszej kolejności bezpieczniej jest sprawdzić stan WSL, historię aktualizacji, komunikaty w terminalu oraz dostępne miejsce na dysku.

Jeżeli błąd dotyczy tylko jednej dystrybucji, przyczyną może być uszkodzony pakiet konkretnego wydania. Jeżeli nie uruchamia się żadna dystrybucja, większe znaczenie ma konfiguracja systemu Windows, wersja WSL albo brak wymaganego jądra. Takie rozróżnienie skraca drogę do właściwego rozwiązania.

Kiedy najlepiej umówić wizytę serwisową - Instalacja dystrybucji kończy się błędem

Do serwisu warto zgłosić się wtedy, gdy aktualizacja WSL nie rozwiązuje problemu, instalator wielokrotnie zatrzymuje się w tym samym miejscu albo pojawiają się dodatkowe komunikaty dotyczące funkcji systemowych, uprawnień i uszkodzonych składników Windows. Pomoc może być potrzebna również wtedy, gdy środowisko ma zostać skonfigurowane do pracy z narzędziami programistycznymi, a jednocześnie na komputerze znajdują się ważne dane i nie ma pewności, które elementy można bezpiecznie usunąć.

Przed przekazaniem urządzenia dobrze jest zanotować pełną treść błędu, używaną wersję Windows, nazwę instalowanej dystrybucji oraz wynik poleceń wsl --status i wsl --list --verbose. Takie informacje ułatwiają odtworzenie problemu i ograniczają ryzyko wykonywania przypadkowych zmian w konfiguracji.

W Warszawskim Pogotowiu Komputerowym 24/7 można zlecić sprawdzenie przyczyny błędu WSL, a w przypadku laptopa skorzystać z tego, że diagnoza LAPTOPA jest darmowa. W ramach sprawdzenia analizuje się stan aktualizacji, wymagane funkcje Windows, konfigurację WSL oraz ewentualne pozostałości po przerwanych instalacjach, z uwzględnieniem bezpieczeństwa zapisanych danych.

Nie należy ignorować komunikatu, jeżeli instalacja kończy się błędem przy każdym uruchomieniu lub powoduje kolejne problemy z aktualizacjami systemu. Wczesne sprawdzenie konfiguracji zwykle pozwala ustalić, czy wystarczy aktualizacja jądra, włączenie brakującej funkcji, naprawa składników Windows, czy też ponowna instalacja środowiska z zachowaniem potrzebnych plików.