diff --git a/docs/docs/_partial-wsl-install.mdx b/docs/docs/_partial-wsl-install.mdx index 7cab4029..4db6d1dd 100644 --- a/docs/docs/_partial-wsl-install.mdx +++ b/docs/docs/_partial-wsl-install.mdx @@ -1,12 +1,18 @@ 1. [Install WSL](https://learn.microsoft.com/en-us/windows/wsl/install) with the Ubuntu distribution using WSL 2: - ```powershell - wsl --install -d Ubuntu - ``` + ```powershell + wsl --install -d Ubuntu + ``` - For new installations, the `wsl --install` command uses WSL 2 and Ubuntu by default. + For new installations, the `wsl --install` command uses WSL 2 and Ubuntu by default. - For existing WSL installations, you can [change the distribution](https://learn.microsoft.com/en-us/windows/wsl/install#change-the-default-linux-distribution-installed) and [check the WSL version](https://learn.microsoft.com/en-us/windows/wsl/install#upgrade-version-from-wsl-1-to-wsl-2). + For existing WSL installations, you can [change the distribution](https://learn.microsoft.com/en-us/windows/wsl/install#change-the-default-linux-distribution-installed) and [check the WSL version](https://learn.microsoft.com/en-us/windows/wsl/install#upgrade-version-from-wsl-1-to-wsl-2). + + :::warning Known limitation + OpenRAG isn't compatible with nested virtualization, which can cause networking issues. + Don't install OpenRAG on a WSL distribution that is installed inside a Windows VM. + Instead, install OpenRAG on your base OS or a non-nested Linux VM. + ::: 2. [Start your WSL Ubuntu distribution](https://learn.microsoft.com/en-us/windows/wsl/install#ways-to-run-multiple-linux-distributions-with-wsl) if it doesn't start automatically. @@ -16,4 +22,4 @@ 5. Install and run OpenRAG from within your WSL Ubuntu distribution.
-If you encounter issues with port forwarding or the Windows Firewall, you might need to adjust the [Hyper-V firewall settings](https://learn.microsoft.com/en-us/windows/security/operating-system-security/network-security/windows-firewall/hyper-v-firewall) to allow communication between your WSL distribution and the Windows host. For more troubleshooting advice for networking issues, see [Troubleshooting WLS common issues](https://learn.microsoft.com/en-us/windows/wsl/troubleshooting#common-issues). \ No newline at end of file +If you encounter issues with port forwarding or the Windows Firewall, you might need to adjust the [Hyper-V firewall settings](https://learn.microsoft.com/en-us/windows/security/operating-system-security/network-security/windows-firewall/hyper-v-firewall) to allow communication between your WSL distribution and the Windows host. For more troubleshooting advice for networking issues, see [Troubleshooting WSL common issues](https://learn.microsoft.com/en-us/windows/wsl/troubleshooting#common-issues). \ No newline at end of file