diff --git a/docs/developer-docs/getting-started/install/index.mdx b/docs/developer-docs/getting-started/install/index.mdx index a3b7793234..3ee40dd16f 100644 --- a/docs/developer-docs/getting-started/install/index.mdx +++ b/docs/developer-docs/getting-started/install/index.mdx @@ -83,7 +83,7 @@ softwareupdate --install-rosetta There is no native support for dfx on Windows. However, you can develop ICP canisters on Windows using a Docker container or by installing the Windows Subsystem for Linux (WSL). -## Using Docker +#### Using Docker Docker is a containerization software that allows you to run a localized version of another operating system, such as Linux, then run Linux-based software and applications. Containers do not have access to the files and applications outside of the container unless given explicit permission. @@ -134,13 +134,13 @@ This should return the version of `dfx` that was installed: dfx 0.18.0 ``` -## Using WSL 2 +#### Using WSL 2 Follow Microsoft's instructions for installing the Windows Subsystem for Linux. Make sure you are running Windows 10 (version 2004 or higher) or Windows 11. -### Supported WSL Versions +#### Supported WSL Versions Theoretically, WSL 1 and WSL 2 should both allow you to run dfx. However, it is recommended to use WSL 2. WSL Comparison explains the differences between WSL1 and WSL 2. -### Check your WSL version +#### Check your WSL version Run the command wsl –list –verbose (wsl -l -v) to check the Linux distributions installed on your Windows machine. Below is an example output: ```bash @@ -150,7 +150,7 @@ Run the command wsl –list –verbose (wsl -l -v) to check the Lin To learn more about the wsl command, check the command reference for WSL. -### Upgrade from WSL 1 +#### Upgrade from WSL 1 If you have WSL 1 installed, follow the upgrade instructions to upgrade to WSL 2. Basically you need to: