Skip to content

Commit

Permalink
Add instructions to disable Docker Desktop integration
Browse files Browse the repository at this point in the history
  • Loading branch information
kaelemc committed Dec 4, 2024
1 parent 9acc756 commit 6ff6a8d
Show file tree
Hide file tree
Showing 2 changed files with 14 additions and 0 deletions.
14 changes: 14 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,7 @@ A WSL distribution designed for easy 'plug and play' usage with [Containerlab](h
>
> [Download](https://github.com/microsoft/WSL/releases/tag/2.4.4)

| **OS** | **Supported** | **VM-based NOSes** |
|:----------:|---------------|--------------------|
| Windows 10 | Yes | No |
Expand All @@ -19,10 +20,13 @@ We recommend using Windows Terminal for the best experience:

# Quick start

**Ensure WSL2.4.4 or newer is installed.**

- Download the `.wsl` file from the [releases page](https://github.com/kaelemc/wsl-clab/releases/latest).
- Double click the `.wsl` file to install.
- Open 'Containerlab' from the start menu, or execute `wsl -d Containerlab`
- Complete the interactive shell selection.
- If you have Docker Desktop installed. See [Docker Desktop](#docker-desktop).
- Done! you can start labbing.

# WSL installation
Expand Down Expand Up @@ -156,6 +160,16 @@ WSL2 runs as a VM. By default allocated resources are:
Despite the fairly generous resource allocation by default. WSL2 will not use 100% of the assigned resources.
# Docker desktop
If you have Docker desktop installed. You **must** ensure the integration with the Containerlab WSL distro is disabled, otherwise Containerlab will not work inside Containerlab WSL.
1. Open Docker Desktop window and go to settings (gear icon on the title bar)
2. Under the 'Resources tab, enter the 'WSL integration' page
3. Ensure 'Containerlab' has integration disabled
![](./images/docker_desktop_integration.png)
# Developers
Development should be performed from another WSL distribution.
Expand Down
Binary file added images/docker_desktop_integration.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 6ff6a8d

Please sign in to comment.