You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Remove 3 troubleshooting entries that are no longer relevant:
1. DigitalOcean: error tagging resource
- Fixed in 2018 when tagging was moved to droplet creation
- The separate tagging step that caused this error no longer exists
2. Docker: Failed to connect to the host via ssh
- 6+ years old workaround for control_path_dir
- Modern Docker deployments don't exhibit this issue
- The workaround was never added to ansible.cfg
3. Ubuntu Error: unable to write 'random state'
- OpenSSL 3.x (Ubuntu 22.04) doesn't use .rnd files
- Algo now uses Ansible community.crypto modules instead of
shell openssl commands
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <[email protected]>
Copy file name to clipboardExpand all lines: docs/troubleshooting.md
-57Lines changed: 0 additions & 57 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -11,14 +11,11 @@ First of all, check [this](https://github.com/trailofbits/algo#features) and ens
11
11
*[AWS: SSH permission denied with an ECDSA key](#aws-ssh-permission-denied-with-an-ecdsa-key)
12
12
*[AWS: "Deploy the template" fails with CREATE_FAILED](#aws-deploy-the-template-fails-with-create_failed)
13
13
*[AWS: not authorized to perform: cloudformation:UpdateStack](#aws-not-authorized-to-perform-cloudformationupdatestack)
14
-
*[DigitalOcean: error tagging resource 'xxxxxxxx': param is missing or the value is empty: resources](#digitalocean-error-tagging-resource)
15
14
*[Azure: The client xxx with object id xxx does not have authorization to perform action Microsoft.Resources/subscriptions/resourcegroups/write' over scope](#azure-deployment-permissions-error)
16
15
*[Windows: The value of parameter linuxConfiguration.ssh.publicKeys.keyData is invalid](#windows-the-value-of-parameter-linuxconfigurationsshpublickeyskeydata-is-invalid)
17
-
*[Docker: Failed to connect to the host via ssh](#docker-failed-to-connect-to-the-host-via-ssh)
18
16
*[Windows: "The parameter is incorrect" error when connecting](#windows-the-parameter-is-incorrect-error-when-connecting)
19
17
*[Error: Failed to create symlinks for deploying to localhost](#error-failed-to-create-symlinks-for-deploying-to-localhost)
20
18
*[Wireguard: Unable to find 'configs/...' in expected paths](#wireguard-unable-to-find-configs-in-expected-paths)
21
-
*[Ubuntu Error: "unable to write 'random state'" when generating CA password](#ubuntu-error-unable-to-write-random-state-when-generating-ca-password)
22
19
*[Timeout when waiting for search string OpenSSH in xxx.xxx.xxx.xxx:4160](#old-networking-firewall-in-place)
23
20
*[Linode Error: "Unable to query the Linode API. Saw: 400: The requested distribution is not supported by this stackscript.; "](#linode-error-uable-to-query-the-linode-api-saw-400-the-requested-distribution-is-not-supported-by-this-stackscript)
This error indicates you already have Algo deployed to Cloudformation. Need to [delete it](cloud-amazon-ec2.md#cleanup) first, then re-deploy.
123
120
124
-
### DigitalOcean: error tagging resource
125
-
126
-
You tried to deploy Algo to DigitalOcean and you received an error like this one:
127
-
128
-
```
129
-
TASK [cloud-digitalocean : Tag the droplet] ************************************
130
-
failed: [localhost] (item=staging) => {"failed": true, "item": "staging", "msg": "error tagging resource '73204383': param is missing or the value is empty: resources"}
131
-
failed: [localhost] (item=dbserver) => {"failed": true, "item": "dbserver", "msg": "error tagging resource '73204383': param is missing or the value is empty: resources"}
132
-
```
133
-
134
-
The error is caused because Digital Ocean changed its API to treat the tag argument as a string instead of a number.
This is related to [the chmod issue](https://github.com/Microsoft/WSL/issues/81) inside /mnt directory which is NTFS. The fix is to place Algo outside of /mnt directory.
191
169
192
-
### Docker: Failed to connect to the host via ssh
193
-
194
-
You tried to deploy Algo from Docker and you received an error like this one:
195
-
196
-
```
197
-
Failed to connect to the host via ssh:
198
-
Warning: Permanently added 'xxx.xxx.xxx.xxx' (ECDSA) to the list of known hosts.\r\n
199
-
Control socket connect(/root/.ansible/cp/6d9d22e981): Connection refused\r\n
200
-
Failed to connect to new control master\r\n
201
-
```
202
-
203
-
You need to add the following to the ansible.cfg in repo root:
204
-
205
-
```
206
-
[ssh_connection]
207
-
control_path_dir=/dev/shm/ansible_control_path
208
-
```
209
-
210
170
### Windows: "The parameter is incorrect" error when connecting
211
171
212
172
When trying to connect to your Algo VPN on Windows 10/11, you may receive an error stating "The parameter is incorrect". This is a common issue that can usually be resolved by resetting your Windows networking stack.
@@ -297,23 +257,6 @@ rm -rf configs/*
297
257
```
298
258
Then immediately re-run `./algo`.
299
259
300
-
### Ubuntu Error: "unable to write 'random state'" when generating CA password
301
-
302
-
When running Algo, you received an error like this:
303
-
304
-
```
305
-
TASK [common : Generate password for the CA key] ***********************************************************************************************************************************************************
This happens when your user does not have ownership of the `$HOME/.rnd` file, which is a seed for randomization. To fix this issue, give your user ownership of the file with this command:
310
-
311
-
```
312
-
sudo chown $USER:$USER $HOME/.rnd
313
-
```
314
-
315
-
Now, run Algo again.
316
-
317
260
### Old Networking Firewall In Place
318
261
319
262
You may see the following output when attemptint to run ./algo from your localhost:
0 commit comments