Return to Facebook   Twitter   Reddit   Instagram   Mastodon   ProtonMail
Support Center / Troubleshooting common macOS app issues

Troubleshooting common macOS app issues

This article covers solutions to common bugs encountered while using the ProtonVPN app for macOS. If the issue you’re facing is not listed here, you can contact our support team for further assistance. 

General issues

This category includes interface bugs you might encounter while using the app. The best thing to do is to reset the app to its default settings:

  1. Open the ProtonVPN app.
  2. Select Help in the app toolbar located at the top.
  3. Click Clear Application Data
  4. The app has now been reset to its default settings.

ProtonVPN keychain error

If you enter the wrong login credentials several times, you might encounter this error message:

If this appears, please verify your username and password. If you do not yet have an account, you can sign up for a Free plan for macOS.

The Network Extension Agent, also known as neagent, enables your Mac to receive VPN authentication data from the keychain system. To allow your Mac to establish a VPN connection, you will need to enter your system password. Select Allow or Always Allow.

To resolve the keychain error, log out of your Mac user account and log back in. Alternatively, you can restart your Mac.

Network request timed out

You might encounter the following error message when logging in:

This indicates a possible error with your network, or that the ProtonVPN infrastructure is currently experiencing downtime or maintenance. To fix this issue, follow these basic troubleshooting steps:

  1. Restart your Mac and log back in to the app.
  2. Check if you can access the ProtonVPN or ProtonMail website.
  3. Check if you can log in to your ProtonVPN account on other devices.
  4. Go to System PreferencesNetwork. Turn your WiFi off and on or unplug and replug your ethernet cable. 
  5. Wait a few minutes before logging in again.

Advanced troubleshooting: 

  1. Open a terminal window: Press and hold the Command button () and the spacebar. Type in terminal in the search bar. 
  2.  Ping ProtonVPN by typing ping in the terminal window.
  3.  Run a traceroute by typing traceroute in the terminal window.

If both operations are successful, there could be something wrong with your network or device. However, if you do not get a response from either operation, please contact our support team with this data, along with your device and ISP information.

Are you trying to access our VPN servers from countries that restrict internet and VPN access? Examples of these countries include China, the UAE, Turkey, Egypt, Syria, Cuba, Saudi Arabia, Iran, and others. If so, your ISP might be targeting and blocking access to ProtonVPN. In that case, try setting up an OpenVPN connection via Tunnelblick.

Post Comment


  1. Blake

    this requires 12.2 but my OS X only goes up to 12.1, do you have an older version that will work on my computer?

  2. ProtonVPN Team

    Hello Blake. There seems to be something wrong here. Our software is supported from 10.12 and above. Did you mean 10.12.2? Please contact our customer support team for detailed troubleshooting.

  3. EM

    I am getting an “internal API error” (in red) when opening ProtonVPN for the first time on MacOS High Sierra.
    Am I missing something?

  4. ProtonVPN Team

    Hello, Please restart the mac device and if that does not help please contact our customer support team here and we will do our best to help you out!

  5. Lijah

    Why it kept on asking for password? When i’m connecting to united states?

  6. ProtonVPN Team

    Hello, please contact our customer support team as we need additional information.

  7. Henry Dilfinger

    I have the same dreaded “Keychain error”.
    It seems ridiculous to have to logout and reboot my machine anytime I want to connect to the VPN. If I wanted to do retarded windoze type reboots every time I do something I wouldn’t be using a UNIX based OS. Please fix this issue, it’s obviously not user error, but something within the scope of your vpn application.

  8. ProtonVPN Team

    Hello Henry. Please press CMD+ Space (search bar will appear)> type Keychain Access> press on the lock in the corner (in order to have administrator privileges)> in the same window search bar type- “VPN”.

    Right click and choose Delete all the files related to ProtonVPN, OpenVPN or Tunnelblick. This will delete remembered passwords for connections that you had with our servers.

    After all of this try connecting again, it should prompt you for your credentials, keep in mind that it may also ask for your Mac’s user account info too.

  9. Garry

    No joy from here either, I was being asked for OpenVPN Password originally, however don’t believe i have that info. Now i just get Keychain error

  10. ProtonVPN Team

    Hello Garry, the time you install our application and log in with your protonvpn account, you make a connection and then you are asked for keychain password – that is your mac user password that you use to log in to your mac when you wake it up. If you face any issues we would suggest contacting the support

  11. osox

    OSX 10.12.6 app v1.2.3 is not working at all, same issues as js above. Had to dig into the os logs since pv logs don´t show either. Works from windows pc app in the same network. I have restarted the Mac, this is the only active session, etc. Logs seem to include PI so I’m only pasting this bit here:
    11:40:11.527433 -0500 secd ProtonVPN[1040] copy_matching Error Domain=NSOSStatusErrorDomain Code=-50 “query missing class name” (paramErr: error in user parameter list) UserInfo={NSDescription=query missing class name}

  12. ProtonVPN Team

    Hello Osox. This is a quite strange error that we don’t recall if we have seen it. It would be the best if you contacted our tech support via email form for detailed investigation.

  13. NW

    Regarding the “Keychain error” message I can say that it is not occuring in non-root users on macOS X High Sierra (version 10.13.6 Beta (17G39b)) with ProtonVPN on version 1.2.3.
    However, if logged into the root user I will always get this error message. I think it’s due to the right management in macOS but it may be worth including that in the article.

  14. Brian Phillips

    Sent an email to support but having the same problems. I live in China. I have the most up to date software and installed TunnelBlick and the new ProtonVPN software. I am not able to connect with either software, followed all of the instructions from the site

  15. ProtonVPN Team

    Hello Brian, our customer support team will keep you in contact and troubleshoot you further on. :)

  16. Jlm

    I get a sad face over the message “Connecting Failed” and the options [Cancel] and [Try again].
    Running macOS 10.13.5.
    Using ProtonVPN on Win 7 works fine using my ISP, Bredbandsbolaget/Sweden.

  17. ProtonVPN Team

    Hello, please contact our customer support team and we will surely help you out!

  18. Chris

    Any chance that this will come to older but still supported versions of macOS (thinking 10.12)? I have some older machines which I can’t upgrade to 10.12 that I still use and would love the convenience of the ProtonVPN app.

  19. ProtonVPN Team

    Hello Chris. Sadly, for now there are no plans to support older macOS versions that are below 10.12. We`ll let our customers know on social media if any changes will come.

  20. Traveler

    I often travel to China, UAE, Qatar, Turkey, … May I use MacOS beta from there or only tunnelblick and securecore ?

  21. ProtonVPN Team

    Hello. Currnetly macOS application will most likely not work due to its used IKEv2 protocol, but it can work, it only depends on ISP most of the times. The best working solution is Tunnelblick as it uses openvpn which is working most of the times in restricted countries.

  22. JS

    I have downloaded the MAC beta client and followed the tutorial to copy it to applications, when i click on it to open it it doesn’t do anything (i get no error messages and i don’t get the logon screen). Eventually i get a message that says that the application has closed unexpectedly. The error report states : Exception Type: EXC_CRASH (Code Signature Invalid), Reason: Namespace CODESIGNING, Code 0x1
    I have tried restarting my MAC and starting again from scratch – i get the same issue. Am I missing something?

  23. ProtonVPN Team

    Hello, May we ask, what application version do you have installed?
    Try using this application which has it fixed, then update to the latest one.

  24. JS

    Hi – i downloaded the client from the protonvpn site at the time that i tried this originally. Unfortunately I didn’t have a chance to try this again until today and your download link has expired. Is the fix that you mention in the beta software generally downloadable from the protonvpn site now?

  25. ProtonVPN Team

    Hello JS, yes, the updated software version is stored on our website and you can download it from here –

  26. JS

    I’ve tried downloading this and following the instructions again. I still cannot get the application to run. It installs and i can double-click on the icon but it does nothing at all until i get an error message that states that the application closed unexpectedly. The log has the same error message as before “Termination Reason: Namespace CODESIGNING, Code 0x1”. Any idea if there is anything else i can try or should i give up?

  27. ProtonVPN Team

    Hello Js, have you tried restarting the mac and performing the installation again? Also, is this the first time installing the ProtonVPN mac application? Please dont hesitate to contact our customer support team here –

  28. CN

    I have tried my correct password for OpenVPN.
    I tried the correct password for ProtonVPN.
    I tried the correct keychain password for my computer.
    I restarted my application. Still nothing.
    I have been at this for over an hour.
    What exactly is keychain password for OpenVPN if it is not the same as the OpenVPN password?

  29. ProtonVPN Team

    May we ask, have you tried restarting your mac?
    When keychain access comes up, you have to enter your Mac User password that you use to log in to your laptop.
    If you still face issues with our application, we recommend contact our support via this form:

  30. EN

    I have the same issue CN has described. I’ve been trying over several days and have ZERO luck. I have no issues using the VPN via Tunnelblick but when trying with ProtonVPN client, none of the keychain passwords work. Like CN, I have used the protonmail password, the previousy used mailbox password, the original password used for tunnelblick and the apple ID. Needless to say, since I have been attempting to get this to work over several days, I have logged out, rebooted, etc. I’ve even uninstalled and reinstalled. Help. (Note: I also updated to MacOS X10.13.6 since my earlier OS was not compatible.)

  31. ProtonVPN Team

    Hello! Harder issues should be discussed with our support team hear for more fluid and convenient conversation since we will need some files. Would you mind contacting us here :

Leave a Reply

Your email address will not be published. Required fields are marked *

Don't find your answer? We're happy to help you!     Contact Our Support Team

Secure your internet

Get ProtonVPN

For customer support inquiries, please submit the following form for the fastest response:
Support Form

For all other inquiries:

Version: OpenPGP.js v4.10.10


You can also Tweet to us: