@@ -3,30 +3,28 @@ title: Custom kernels on WSL
33description : Using custom kernels with Docker Desktop on WSL 2
44keywords : wsl, docker desktop, custom kernel
55tags : [Best practices, troubleshooting]
6- aliases :
7- - /desktop/wsl/custom-kernels/
86---
97
108Docker Desktop depends on several kernel features built into the default
11- WSL 2 Linux kernel distributed by Microsoft. Because of that, ** using a
12- custom kernel with Docker Desktop on WSL 2 is not officially supported**
9+ WSL 2 Linux kernel distributed by Microsoft. Consequently, using a
10+ custom kernel with Docker Desktop on WSL 2 is not officially supported
1311and may cause issues with Docker Desktop startup or operation.
1412
15- At the same time, we understand that in some cases it may be necessary
13+ However, in some cases it may be necessary
1614to run custom kernels; Docker Desktop does not block their use, and
1715some users have reported success using them.
1816
19- If you choose to use a custom kernel, we suggest starting
20- from the kernel tree distributed by Microsoft at their [ official
21- repository] ( https://github.com/microsoft/WSL2-Linux-Kernel ) and adding
17+ If you choose to use a custom kernel, it is recommended you start
18+ from the kernel tree distributed by Microsoft from their [ official
19+ repository] ( https://github.com/microsoft/WSL2-Linux-Kernel ) and then add
2220the features you need on top of that.
2321
24- We suggest to :
22+ It's also recommended that you :
2523- Use the same kernel version as the one distributed by the latest WSL2
26- release (you can find the version by running ` wsl.exe --system uname -r `
27- in a terminal) .
24+ release. You can find the version by running ` wsl.exe --system uname -r `
25+ in a terminal.
2826- Start from the default kernel configuration as provided by Microsoft
29- in their [ repository] ( https://github.com/microsoft/WSL2-Linux-Kernel )
27+ from their [ repository] ( https://github.com/microsoft/WSL2-Linux-Kernel )
3028and add the features you need on top of that.
3129- Make sure that your kernel build environment includes ` pahole ` and
3230its version is properly reflected in the corresponding kernel config
0 commit comments