From 972723a1397a85f24ed895bb28ed224fded48d15 Mon Sep 17 00:00:00 2001 From: jabacrack Date: Tue, 14 Jun 2022 00:13:35 +0300 Subject: [PATCH] update windows deployment documentation (#14470) --- docs/deploy-from-windows.md | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) diff --git a/docs/deploy-from-windows.md b/docs/deploy-from-windows.md index 9409a96..ac6ba49 100644 --- a/docs/deploy-from-windows.md +++ b/docs/deploy-from-windows.md @@ -39,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: