diff --git a/docs/docsite/rst/user_guide/windows_faq.rst b/docs/docsite/rst/user_guide/windows_faq.rst index 75e99d2ea8b86d..f6bdfced377859 100644 --- a/docs/docsite/rst/user_guide/windows_faq.rst +++ b/docs/docsite/rst/user_guide/windows_faq.rst @@ -70,6 +70,21 @@ installed version and then clone the git repo. # To enable Ansible on login, run the following echo ". ~/ansible/hacking/env-setup -q' >> ~/.bashrc +If you encounter timeout errors when running Ansible on the WSL, this may be due to an issue +with ``sleep`` not returning correctly. The following workaround may resolve the issue: + +.. code-block:: shell + + mv /usr/bin/sleep /usr/bin/sleep.orig + ln -s /bin/true /usr/bin/sleep + +Another option is to use WSL 2 if running Windows 10 later than build 2004. + +.. code-block:: shell + + wsl --set-default-version 2 + + Can I use SSH keys to authenticate to Windows hosts? ```````````````````````````````````````````````````` You cannot use SSH keys with the WinRM or PSRP connection plugins.