How to troubleshoot macOS issues?

Daemon updater stuck (version v2.0.0 or higher):

1. Go to System Settings / General / Login Items & Extensions

2. Scroll down to the NymVPN item and toggle it off

3. Wait a few seconds, and toggle it on again

Daemon stuck or daemon migration issues v1.8.2:

1. Disable the daemon background process

Mac ➡️ System Settings ➡️ General ➡️ Login Items & Extensions
Allow in background section

2. Unload daemon:

sudo launchctl unload /Library/LaunchDaemons/net.nymtech.vpn.helper.plist

3. Remove configuration file from LaunchDaemons

sudo rm /Library/LaunchDaemons/net.nymtech.vpn.helper.plist

4. Remove the executable

sudo rm /Library/PrivilegedHelperTools/net.nymtech.vpn.helper

4.1 Optional. Verify if daemon has been removed successfully

ps aux | grep net.nymtech.vpn.helper

Output of ps aux | grep net.nymtech.vpn.helper -> daemon is running, go back to steps above:

User 18624 0.0 0.0 410732336 1600 s007 S+ 4:52PM 0:00.00 grep --color=auto --exclude-dir=.bzr --exclude-dir=CVS --exclude-dir=.git --exclude-dir=.hg --exclude-dir=.svn --exclude-dir=.idea --exclude-dir=.tox net.nymtech.vpn.helper
root 18386 0.0 0.1 412474368 32352 ?? Ss 4:39PM 0:00.41 Contents/MacOS/net.nymtech.vpn.helper --run-as-service

Output of ps aux | grep net.nymtech.vpn.helper -> daemon is not running, carry on:

User 18664 1.0 0.0 410724144 1488 s007 S+ 4:52PM 0:00.00 grep --color=auto --exclude-dir=.bzr --exclude-dir=CVS --exclude-dir=.git --exclude-dir=.hg --exclude-dir=.svn --exclude-dir=.idea --exclude-dir=.tox net.nymtech.vpn.helper

5. Reset login and background item data

sfltool resetbtm

6. Restart mac.

7. Install the latest NymVPN app version or use the in app updater.

https://nym.com/download/macos 

8. After install of latest version click "Connect" and go through steps to install the daemon.

Side notes:

• v1.8.0 introduced daemon migration. Known issues - daemon migration can get stuck.
• v1.8.2 fixes the migration gets stuck issue.
• v2.0.1 is the latest version of 13th March 2025 and the most recommended one to use.

Problems After Logging Out

Some users have reported being unable to enter their access code after logging out of NymVPN. This issue may occur due to a credentials-related problem in the local database.

To resolve this, try clearing your local credentials by running the following command in your terminal:

sudo rm -rf /var/lib/nym-vpnd

After running the command, restart NymVPN and try logging in again with your access code.

⚠️ Note: You may be prompted to enter your system password when using sudo.