From f6fc9357b28bac530b18fd3179adee559ee72a64 Mon Sep 17 00:00:00 2001
From: Vladimir Robustov <vladimirr@evmtech.com>
Date: Tue, 29 Mar 2022 17:38:37 +0300
Subject: [PATCH] update windows deployment

---
 docs/deploy-from-windows.md | 35 ++++++++++++++++++++++++++---------
 1 file changed, 26 insertions(+), 9 deletions(-)

diff --git a/docs/deploy-from-windows.md b/docs/deploy-from-windows.md
index dabe758..a7bae0f 100644
--- a/docs/deploy-from-windows.md
+++ b/docs/deploy-from-windows.md
@@ -23,15 +23,6 @@ Wait a minute for Windows to install a few things in the background (it will eve
 4. The subsystem will be installed, then Windows will require a restart.
 5. Restart Windows and then [install Ubuntu 18.04 LTS from the Windows Store](https://www.microsoft.com/p/ubuntu-1804-lts/9n9tngvndl3q) (at this time Ubuntu 20.04 LTS does not work with Algo when running under WSL).
 6. Run Ubuntu from the Start menu. It will take a few minutes to install. It will have you create a separate user account for the Linux subsystem. Once that's done, you will finally have Ubuntu running somewhat integrated with Windows.
-7. Start Ubuntu Terminal.
-8. Edit /etc/wsl.conf (create it if it doesn't exist). Add the following:
-```
-[automount]
-options = "metadata"
-```
-9. Close all opened Ubuntu Terminals.
-10. Run powershell.
-11. Run `wsl --shutdown` in powershell.
 
 ## Install Algo
 
@@ -48,6 +39,32 @@ git clone https://github.com/trailofbits/algo
 cd algo
 ```
 
+## Post installation steps
+
+These steps should be only if you clone the Algo repository to the host machine disk (C:, D:, etc.). WSL mount host system disks to `\mnt` directory.
+
+### Allow git to change files metadata
+
+By default git cannot change files metadata (using chmod for example) for files stored at host machine disks (https://docs.microsoft.com/en-us/windows/wsl/wsl-config#set-wsl-launch-settings). Allow it:
+
+1. Start Ubuntu Terminal.
+2. Edit /etc/wsl.conf (create it if it doesn't exist). Add the following:
+```
+[automount]
+options = "metadata"
+```
+3. Close all Ubuntu Terminals.
+4. Run powershell.
+5. Run `wsl --shutdown` in powershell.
+
+### Allow  run Ansible in a world writable directory
+
+Ansible threat host machine directories as world writable directory and do not load .cfg from it by default (https://docs.ansible.com/ansible/devel/reference_appendices/config.html#cfg-in-world-writable-dir). For fix run inside `algo` directory:
+
+```shell
+chmod 744 .
+```
+
 Now you can continue by following the [README](https://github.com/trailofbits/algo#deploy-the-algo-server) from the 4th step to deploy your Algo server!
 
 You'll be instructed to edit the file `config.cfg` in order to specify the Algo user accounts to be created. If you're new to Linux the simplest editor to use is `nano`. To edit the file while in the `algo` directory, run: