Skip to content
Snippets Groups Projects
debug.rst 1.43 KiB
Newer Older
  • Learn to ignore specific revisions
  • 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.