Skip to content

Commit 972723a

Browse files
authored
update windows deployment documentation (#14470)
1 parent 59672d4 commit 972723a

File tree

1 file changed

+26
-0
lines changed

1 file changed

+26
-0
lines changed

docs/deploy-from-windows.md

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -39,6 +39,32 @@ git clone https://github.com/trailofbits/algo
3939
cd algo
4040
```
4141

42+
## Post installation steps
43+
44+
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.
45+
46+
### Allow git to change files metadata
47+
48+
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:
49+
50+
1. Start Ubuntu Terminal.
51+
2. Edit /etc/wsl.conf (create it if it doesn't exist). Add the following:
52+
```
53+
[automount]
54+
options = "metadata"
55+
```
56+
3. Close all Ubuntu Terminals.
57+
4. Run powershell.
58+
5. Run `wsl --shutdown` in powershell.
59+
60+
### Allow run Ansible in a world writable directory
61+
62+
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:
63+
64+
```shell
65+
chmod 744 .
66+
```
67+
4268
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!
4369

4470
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:

0 commit comments

Comments
 (0)