diff --git a/docs/install.md b/docs/install.md index ddc007e7c..551a754c3 100644 --- a/docs/install.md +++ b/docs/install.md @@ -99,6 +99,11 @@ Once installed, issue `sudo service docker start` to start the docker service in It appears to be that next versions of WSL2 kernels will support KVM. +### Mac OS +Containerlab doesn't run on Mac OS because Docker Desktop for Mac doesn't provide the networking features containerlab relies on. + +The workaround for Mac OS users is to start a Linux VM (Virtual Machine) on mac and run Containerlab inside the VM. For example, free software such as Vagrant or Virtualbox can be used to deploy a Linux VM on a Mac OS. + ### Upgrade To upgrade `containerlab` to the latest available version issue the following command[^1]: @@ -124,4 +129,4 @@ To build containerlab from source: [^1]: only available if installed from packages [^2]: Most containerized NOS will require >1 vCPU. RAM size depends on the lab size. Architecture: AMD64. -[^3]: No need to uninstall Docker Desktop, just make sure that it is not integrated with WSL2 machine that you intend to use with containerlab. Moreover, you can make it even work with Docker Desktop with a [few additional steps](https://twitter.com/networkop1/status/1380976461641834500/photo/1), but installing docker-ce into the WSL maybe more intuitive. \ No newline at end of file +[^3]: No need to uninstall Docker Desktop, just make sure that it is not integrated with WSL2 machine that you intend to use with containerlab. Moreover, you can make it even work with Docker Desktop with a [few additional steps](https://twitter.com/networkop1/status/1380976461641834500/photo/1), but installing docker-ce into the WSL maybe more intuitive.