From 970e5b1f449408594580bd09228b883d249cb639 Mon Sep 17 00:00:00 2001 From: Dan Guido Date: Sat, 18 Mar 2017 17:29:25 -0400 Subject: [PATCH] Update TROUBLESHOOTING.md --- docs/TROUBLESHOOTING.md | 15 +++++++++++++-- 1 file changed, 13 insertions(+), 2 deletions(-) diff --git a/docs/TROUBLESHOOTING.md b/docs/TROUBLESHOOTING.md index 3c627c2..712334d 100644 --- a/docs/TROUBLESHOOTING.md +++ b/docs/TROUBLESHOOTING.md @@ -4,7 +4,8 @@ 2. [Error: "fatal error: 'openssl/opensslv.h' file not found"](#2-error-fatal-error-opensslopensslvh-file-not-found) 3. [Little Snitch is broken when connected to the VPN](#3-little-snitch-is-broken-when-connected-to-the-vpn) 4. [Various websites appear to be offline through the VPN](#4-various-websites-appear-to-be-offline-through-the-vpn) -5. [I have a problem not covered here](#5-i-have-a-problem-not-covered-here) +5. +6. [I have a problem not covered here](i-have-a-problem-not-covered-here) ### 1. Error: "You have not agreed to the Xcode license agreements" @@ -61,7 +62,17 @@ Little Snitch is not compatible with IPSEC VPNs due to a known bug in macOS and This issue appears intermittently due to issues with MTU size. If you experience this issue, we recommend [filing an issue](https://github.com/trailofbits/algo/issues/new) for assistance. Advanced users can troubleshoot the correct MTU size by retrying `ping` with the "don't fragment" bit size and decreasing packet size. This will determine the correct MTU size for your network, which you then need to update on your network adapter. -### 5. I have a problem not covered here +### 5. Bad owner or permissions on .ssh + +You tried to run Algo and it quickly exits with an error about a bad owner or permissions: + +``` +fatal: [104.236.2.94]: UNREACHABLE! => {"changed": false, "msg": "Failed to connect to the host via ssh: Bad owner or permissions on /home/user/.ssh/config\r\n", "unreachable": true} +``` + +You need to reset the permissions on your `.ssh` directory. Run `chmod 700 /home/user/.ssh` and then `chmod 600 /home/user/.ssh/config`. You may need to repeat this for other files mentioned in the error message. + +### I have a problem not covered here If you have an issue that you cannot solve with the guidance here, [join our Slack](https://empireslacking.herokuapp.com/) and ask for help in the #tool-algo channel or [file an issue](https://github.com/trailofbits/algo/issues/new) that describes the problem and we'll do our best to help you.