Skip to content
This repository was archived by the owner on Aug 7, 2025. It is now read-only.

Add note on WSL2 path formatting for hot reloading in Rancher Desktop on Windows #1769

Merged
merged 9 commits into from
Jun 26, 2025
15 changes: 15 additions & 0 deletions content/en/user-guide/lambda-tools/hot-reloading/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,6 +40,21 @@
If using Docker Desktop on macOS, you might need to allow [file sharing](https://docs.docker.com/desktop/settings/mac/#file-sharing) for your target folders.
MacOS may prompt you to grant Docker access to your target folders.

**WSL2-compatible paths required with Rancher Desktop on Windows:**
Make sure your Lambda handler paths are specified using WSL2-compatible paths. For example, instead of using a Windows-style path such as:

Check failure on line 44 in content/en/user-guide/lambda-tools/hot-reloading/index.md

View workflow job for this annotation

GitHub Actions / Markdown Lint

Max 1 sentence should be on a line

content/en/user-guide/lambda-tools/hot-reloading/index.md:44:77 max-one-sentence-per-line Max 1 sentence should be on a line [Context: "e paths. For e"] https://github.com/aepfli/markdownlint-rule-max-one-sentence-per-line

```bash
C:\Users\myuser\projects\lambda\handler.py
```

Use the corresponding WSL-style path:

```bash
/mnt/c/Users/myuser/projects/lambda/handler.py
```

This ensures that LocalStack can properly mount and watch your Lambda code inside the container when running under WSL2.

**Layer limit with hot reloading for layers:**
When hot reloading is active for a Lambda layer (Pro), the function can use at most one layer.

Expand Down
Loading