Skip to content
Jeonghun Yang edited this page Mar 22, 2025 · 36 revisions

Kernel Status

Channel Kernel Version
Stable Linux 6.13
LTS Linux 6.12

Kernel Additional Package Installation

NOTICE

  • This guide must be proceed in your WSL2 system.
  • Kernel additional package is optional. If you don't need it, just skip this guide.
  • Additional package contains kernel modules, headers and documents.
  • If you try to use VHDX image, you must use WSL version 2.5.1 or later.

1. Install Additional Package in WSL2 Directly

# Please change latest version of kernel and select your architecture
wget https://github.com/Nevuly/WSL2-Linux-Kernel-Rolling/releases/download/linux-wsl-stable-**x.x.x**/bzImage-**arch**-addon_install.tar.gz

tar -xzvf bzImage-**arch**-addon_install.tar.gz

cd bzImage-**arch**-addon_install

sudo ./addon-install.sh

After execute installation script, please reboot your WSL2 system to load kernel modules correctly.

2. Install Additional Package using VHDX Image

  1. Download kernel additional package VHDX image from [releases page][releases-page].
  2. Place it to somewhere appropriate. (e.g. D:\WSL2\Kernel\bzImage-x86_64-addon.vhdx)
  3. Save the .wslconfig in current user's home directory with following content:
[wsl2]
kernelModules=the\\path\\to\\bzImage-addon.vhdx
; e.g.
; kernelModules=D:\\WSL2\\Kernel\\bzImage-x86_64-addon.vhdx
;
; Note that all `\` should be escaped with `\\`.

Clone this wiki locally