Skip to content

README.md

Latest commit

 

History

History
263 lines (196 loc) · 8.11 KB

README.md

File metadata and controls

263 lines (196 loc) · 8.11 KB

WSL2 Custom Kernel 6.18 LTS Guide (Windows 11 Enterprise)

Kernel License PowerShell Ubuntu

Guide COMPLET et RIGOUREUX : Compilation du noyau Linux 6.18 LTS pour WSL2 sous Windows 11 Enterprise (PowerShell 7.6.1)

Créé le 25 avril 2026 - Expérience réelle avec TOUTES les galères et solutions

Mis à jour le 26 avril 2026 - Ajout de Préparation Complète de l'Environnement

🛠️ Préparation Complète de l'Environnement

Cette section préparatoire essentielle détaille TOUS les prérequis pour éviter les échecs courants. Le guide utilise deux environnements distincts :

  • Windows/PowerShell 7.6.1 : Pour les commandes de gestion WSL (étapes 6-8 : déploiement, .wslconfig, activation).
  • Ubuntu 25.10 (WSL2) : Pour la compilation du noyau (étapes 1-5 : préparation, clonage, make).
Environnement Parties concernées Commandes exécutées Prérequis
PowerShell 7.6.1 (Windows) Étapes 6,7,8 + Activation finale wsl --shutdown, édition .wslconfig Installation manuelle (voir ci-dessous)
Ubuntu 25.10 (WSL2) Étapes 1-5 apt install, git clone, make WSL installé + distro Ubuntu

⚠️ Sans cette préparation, échecs garantis : "wsl introuvable", "pwsh.exe manquant", compilation impossible.

1. Vérifier/Installer WSL2 (si manquant)

WSL2 n'est pas toujours activé sur Windows 11 Enterprise. Vérifiez d'abord :

# Dans PowerShell 5.1 ou 7 (admin)
wsl --version
  • Si erreur "wsl introuvable" → Installez WSL2.
  • Méthode officielle (10 min) :
# Terminal Admin (PowerShell ou CMD)
wsl --install
# Installe WSL2 + noyau par défaut + Ubuntu (première distro)

Redémarrez Windows, puis :

wsl --install -d Ubuntu-25.10  # Si version spécifique souhaitée
wsl --set-default-version 2    # Force WSL2
wsl --update                   # Noyau à jour

Vérification :

wsl --list --verbose  # Doit montrer Ubuntu-25.10 (WSL2). Sinon, installer une distro Linux de votre choix

Problème courant : Virtualisation désactivée → Activez dans BIOS/UEFI ("SVM" AMD / "VT-x" Intel).

2. Installer PowerShell 7.6.1 (Non Natif !)

PowerShell 5.1 est préinstallé sur Windows 11 (tapez powershell). PowerShell 7.6.1 (Core) doit être installé manuellement car cross-platform et moderne.

Méthode Recommandée : Winget (1 ligne)

# Terminal Admin
winget install --id Microsoft.PowerShell --source winget

Alternative : MSI Officiel

  1. Téléchargez PowerShell-7.6.1-win-x64.msi depuis GitHub PowerShell.
  2. Exécutez (avec les droits admin) : msiexec.exe /package PowerShell-7.6.1-win-x64.msi /quiet ADD_EXPLORER_CONTEXT_MENU_OPENPOWERSHELL=1 ADD_PATH=1

Lancement : Tapez pwsh (pas powershell).

Vérification :

pwsh -v  # → 7.6.1
$PSVersionTable  # Détails complets

Différences PowerShell 5.1 vs 7.6.1 (Explication Simple)

Aspect PowerShell 5.1 (Natif Windows) PowerShell 7.6.1 (Core)
Plateforme Windows seulement Windows/Linux/macOS
Performance Plus lente (57x moins sur gros datasets) 57x plus rapide sur pipelines lourds
Fonctionnalités Base Nouvelles : ForEach-Object -Parallel, SSH natif, ternaire (? :), conteneurs Docker
Coexistence powershell.exe pwsh.exe côte-à-côte (pas de conflit)
Utilisation ici OK pour basique Requis pour WSL avancé/performant

Pourquoi 7.6.1 ? Meilleure compatibilité WSL2, scripts cross-platform, futur-proof.

3. Vérifications Finales Avant Guide

# Dans pwsh (admin)
wsl --version              # OK
wsl -l -v                  # Ubuntu prêt
pwsh -v                    # 7.6.1

Espace disque : 6Go+ libre (C:\ + WSL VHDX). RAM : 8Go+ (compilation -j$(nproc)).

Prêt ? Passez à la section suivante ! 🚀

🎯 Pourquoi ce guide ?

Problème identifié : wsl --version affiche 6.6.114.1-1 (obsolète)
Solution validée : 6.18.20.3-microsoft-standard-WSL2+ (LTS jusqu'en 2027)

Avant : 6.6.114.1-1 (2024) - Support fin 2026
Après : 6.18.20.3+ (2026) - Support jusqu'en 2027 ✅

📋 Environnement testé

💻 Windows 11 Enterprise (10.0.26200.8246)
⚡ PowerShell Core 7.6.1
🐧 Ubuntu-25.10 (WSL2)
🐧 Oracle Linux 9.5 (WSL2)
💾 Espace requis : 6Go+ 
🧠 RAM recommandée : 8Go+

🚀 Guide pas à pas (REPRODUCTIBLE)

1. Préparation Ubuntu (WSL2)

sudo apt update && sudo apt upgrade -y
sudo apt install -y build-essential flex bison dwarves libssl-dev libelf-dev bc cpio qemu-utils rsync git

2. Clonage sources OFFICIELLES Microsoft

# BRANCHE CRITIQUE : linux-msft-wsl-6.18.y
git clone --branch linux-msft-wsl-6.18.y https://github.com/microsoft/WSL2-Linux-Kernel.git
cd WSL2-Linux-Kernel

⚠️ ERREUR FATALE : Sans --branch, vous clonez 6.6.y par défaut !

3. Configuration noyau WSL2

make clean
sudo make KCONFIG_CONFIG=Microsoft/config-wsl

4. Compilation (⏱️ 20-40min)

# COMMANDE UNIQUE Microsoft OFFICIELLE
sudo make -j$(nproc) KCONFIG_CONFIG=Microsoft/config-wsl && \
sudo make INSTALL_MOD_PATH="$PWD/modules" modules_install KCONFIG_CONFIG=Microsoft/config-wsl

Succès :

DEPMOD  /modules/lib/modules/6.18.20.3-microsoft-standard-WSL2+

5. Vérification

ls -lh arch/x86/boot/bzImage           # 17.5Mo ✓
ls modules/lib/modules/6.18.20.3-microsoft-standard-WSL2+/  # Modules ✓

6. Déploiement Windows

mkdir -p /mnt/c/wsl-kernels/6.18.20.3/
cp arch/x86/boot/bzImage /mnt/c/wsl-kernels/6.18.20.3/
cp -r modules/lib/modules/6.18.20.3-microsoft-standard-WSL2+ /mnt/c/wsl-kernels/6.18.20.3/modules/

7. Configuration .wslconfig

Fichier : C:\Users\bbrod\.wslconfig

[wsl2]
kernel=C:\\wsl-kernels\\6.18.20.3\\bzImage

8. Activation

# PowerShell (admin)
wsl --shutdown
wsl

Test final :

uname -r
# → 6.18.20.3-microsoft-standard-WSL2+  🎉

🐛 GALÈRES & SOLUTIONS réelles

Problème Cause Solution
No such file or directory (VHDX) WSL2+ vs WSL2 Copie manuelle /modules/
wsl --version → 6.6 Info statique Microsoft uname -r = vérité
OOM compilation -j$(nproc) trop élevé make -j4
Dépendances manquantes bc, rsync apt install bc rsync

📊 Résultats

Métrique Avant Après
Noyau 6.6.114.1-1 6.18.20.3-microsoft-standard-WSL2+
Support LTS Fin 2026 Fin 2027
Distros impactées Aucune Ubuntu + Oracle Linux
wsl --version 6.6.114.1-1 6.6.114.1-1 (statique)

🧹 Nettoyage

cd ~
rm -rf WSL2-Linux-Kernel/  # Libère 3Go

🔄 Maintenance

Mise à jour :

cd WSL2-Linux-Kernel
git pull origin linux-msft-wsl-6.18.y
# Étapes 3→8

Rollback :

[wsl2]
# kernel=...  ← Supprimez la ligne

📚 Sources officielles

🪪 Licence

Copyright (c) 2026 valorisa (Bertrand Brodeau)
Licence CC-BY-SA 4.0

🙌 Crédits

Expérience réelle du 25 avril 2026 :

  • Compilation réussie 6.18.20.3-microsoft-standard-WSL2+
  • Toutes galères incluses et résolues
  • Guide 100% reproductible

Vous aussi, passez à 6.18 LTS ! 🚀