How to troubleshoot macOS issues?

This article covers problems you might encounter when using NymVPN on macOS devices. 

macOS app (GUI)

invalid credential: failed to get next usable credential: the credential storage does not contain any usable credentials

You need to enter a valid credential. Please go to Settings > Add credential to connect and add the credential shared by email or generated on our landing page.

Please note that you need to be invited to the NymVPN beta in order to have a valid credential.

no gateway available for location CH, available countries: ["NL", "US", "ID", "BR", "SG", "DE", "BE", "AU", "IT", "GR", "RU", "FI", "NO", "ES", "GB", "HK", "MD", "IN", "SE", "FR", "ZA", "PL"]

This is a known issue due to the app not fetching the list of countries in a unified way between the frontend client and the library. The team is aware and currently working on. 

VPN error on stop

The VPN encountered an error during the shutdown process. Please try stopping the VPN again, and if the issue persists, restart your device or reinstall the VPN application.

Long connection time (~10 seconds)

Connection times of approximately 10 seconds are due to the API's process of selecting the most suitable gateways. The team is currently working on optimizing this process. 

The connection may somewhat seem delayed, as the background process is refining the list of gateways to select which are compatible with the NymVPN offering

gateway client error ([xxx]): Authentication failure
The VPN failed to authenticate. Delete your local keys by using the following procedure:

1. Go to Macintosh HD / Users / [your username] / Library
2. If you can’t see the Library, press Cmd + Shift + . to reveal hidden folders
3. Then continue to Library / Application Support / nym-vpn / backend / mainnet
4. Delete the gateways_registrations.sqlite file, and confirm with your device password
5. Quit the NymVPN app and relaunch it

macOS CLI (Command Line Interface) 

Error: db error IO error: Permission denied (os error 13)
IO error: Permission denied (os error 13)
This error occurs due to an app limitation. Launch the app with root privileges. Open the app using the Terminal and the following command:

sudo /Applications/nym-vpn.app/Contents/MacOS/nym-vpn

Enter your device password when prompted and press Enter.

ERROR nym_connection_monitor::monitor: Entry gateway not routing our mixnet traffic
Verify the status and connectivity of the entry gateway, see if you’re running an existing VPN too, this potentially throws this error message if an existing connection to another provider is in existence. If the problem continues, consider restarting the gateway or checking the routing configurations.

ERROR nym_vpn_lib: Nym VPN returned error: Task 'nym_vpn_lib-mixnet_client_main-gateway_transceiver-child' halted unexpectedly
The task handling the gateway transceiver has halted unexpectedly. Please check the system logs for more detailed error messages that might indicate why the task stopped. Restarting the Nym VPN service should resolve the issue.

ERROR nym_client_core::client::mix_traffic: Failed to send sphinx packet(s) to the gateway: There was a network error: IO error: Broken pipe (os error 32)
This error indicates a broken pipe issue, suggesting a disruption in the connection to the gateway. Please ensure the network connection is stable and the gateway is responsive. Restarting the client or gateway may help resolve this problem.

ERROR nym_gateway_client::client: failed to send message without response - There was a network error: IO error: Broken pipe (os error 32)
Similar to the previous error, this suggests a disruption in the connection. Verify the network stability and check if the gateway service is running properly. A system or service restart on both the client and the gateway might be necessary.

ERROR nym_gateway_client::client: ... and the delegated stream has also errored out - There was a network error: IO error: No route to host (os error 65)
The 'No route to host' error suggests that the network path to the specified host cannot be found. Check the network settings, ensure the host address is correct and reachable. Consider diagnosing the network route using tools like traceroute or ping.

ERROR nym_vpn_lib: Nym VPN returned error: Task 'nym_vpn_lib-mixnet_client_main-gateway_transceiver-child' halted unexpectedly
This repeated error indicates recurring issues with the task managing the gateway transceiver. Investigating the logs for any recurrent patterns or specific error messages prior to the halt might provide more insights. Consider applying updates or patches if available, or escalate to technical support if the issue persists.