Skip to content

Commit fb81817

Browse files
committed
docs: update readme
1 parent 4b38364 commit fb81817

File tree

1 file changed

+12
-1
lines changed

1 file changed

+12
-1
lines changed

README.md

Lines changed: 12 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,18 @@ Microsoft maintains the [WSL2-Linux-Kernel](https://github.com/microsoft/WSL2-Li
1212
- Only distributes kernels through Windows Update
1313
- Makes it difficult to test different kernel versions
1414

15+
I encountered issues while fine-tuning models using **Unsloth**, and I suspect they are related to the WSL2 kernel. To experiment with different WSL kernels, I created this repository.
16+
17+
The specific Unsloth issue can be found here: https://github.com/unslothai/unsloth/issues/1744
18+
Problems I discovered include:
19+
20+
- Some WSL kernel versions have serious memory management issues:
21+
- Memory is requested but cannot be released, even when `pageReporting=true` is enabled.
22+
- `memlock` limits vary—some WSL instances have a higher or even unlimited locked memory cap, but typically the limit is around 2GB. In my tests, it sometimes allows only 2GB, which is entirely dependent on the WSL kernel.
23+
- `memlock` has a hard limit that seems unchangeable within WSL.
24+
- `memlock` appears to overestimate current locked memory; repeated locking of the same memory can be counted multiple times.
25+
- Some WSL kernels are incompatible with Docker Desktop.
26+
1527
This project:
1628
- Automates building official Microsoft kernel sources exactly as released
1729
- Provides access to historical kernel versions
@@ -28,7 +40,6 @@ This project:
2840

2941
## Download Pre-built Kernels
3042

31-
Checkout releases:
3243
https://github.com/lenML/lets-build-wsl2-kernels/releases
3344

3445
## Usage 🚀

0 commit comments

Comments
 (0)