diff options
Diffstat (limited to 'docs/debug.rst')
| -rw-r--r-- | docs/debug.rst | 47 |
1 files changed, 47 insertions, 0 deletions
diff --git a/docs/debug.rst b/docs/debug.rst new file mode 100644 index 0000000..c746cf6 --- /dev/null +++ b/docs/debug.rst @@ -0,0 +1,47 @@ +Troubleshooting +=============== + +This document contains some useful debug information. + +OSX +--- +If you're having troubles with old versions of RiseupVPN that did not have an +uninstaller, and the new installer is not cleanly replacing the previous +install, you might need to manually clean things up. You will need root access to +stop the privileged helper. + +First, see if the helper is running: + +pgrep bitmask-helper + +To stop it: + +sudo launchctl unload /Library/LaunchDaemons/se.leap.bitmask-helper.plist + +To start it: + +sudo launchctl load /Library/LaunchDaemons/se.leap.bitmask-helper.plist +sudo launchctl start /Library/LaunchDaemons/se.leap.bitmask-helper.plist + +Check that it's running: + +pgrep bitmask-helper + +Manually check that the web api is running, and that it reports a version that matches what you currently have installed: + +curl http://localhost:7171/version + +Also, you can check that the path near the end of the file /Library/LaunchDaemons/se.leap.bitmask-helper.plist +matches the current path where you installed RiseupVPN.app. + +Cleaning up +~~~~~~~~~~~ +If you have things messed up and you want to completely delete the bitmask-helper: + +sudo launchctl unload /Library/LaunchDaemons/se.leap.bitmask-helper.plist +sudo rm -rf /Library/LaunchDaemons/se.leap.bitmask-helper.plist + +Make sure that "pgrep bitmask-helper" does not return any pid. + +Now you can move /Applications/RiseupVPN.app to the Trash, and launch a +recent installer to get a clean install. |