Troubleshooting

Below are listed some points which may need to be addressed when testing NymVPN alpha. If you crashed into any errors which are not listed, please contact us at the testing workshop or in the NymVPN Matrix channel.

NymVPN attempts to connect to sandbox testnet

If you testing the latest versions and you correctly expect the client to run over the mainnet, but it listens to https://sandbox-nym-api1.nymtech.net, it’s probably because of your previous configuration.

Check your config.toml either in the directory from which you run your client or in ~/.config/nym-vpn/ and remove sandbox.env from the config file and folder.

If the problem persists (probably due to some locally cache) download mainnet.env and save it to the same directory.

Running GUI failed due to TOML parse error

If you see this error when running NymVPN alpha desktop, it’s because the older versions needed entry location in config.toml configuration file. From v0.0.3 the entry location is selected directly by the user in the application. This error is due to an old app-data.toml config in your computer.

2024-02-15T14:25:02.745331Z ERROR read: nym_vpn_desktop::fs::storage: TOML parse error at line 5, column 1
  |
5 | [entry_node_location]
  | ^^^^^^^^^^^^^^^^^^^^^
wanted exactly 1 element, more than 1 element
 self=AppStorage { data: AppData { monitoring: None, autoconnect: None, killswitch: None, entry_location_selector: None, ui_theme: None, ui_root_font_size: None, vpn_mode: None, entry_node_location: None, exit_node_location: None }, dir_path: "/home/companero/.local/share/nym-vpn", filename: "app-data.toml", full_path: "/home/companero/.local/share/nym-vpn/app-data.toml" }
Error: TOML parse error at line 5, column 1
  |
5 | [entry_node_location]
  | ^^^^^^^^^^^^^^^^^^^^^
wanted exactly 1 element, more than 1 element

Simply delete this file app-data.toml from the path listed in the error message. In the example above it would be /home/companero/.local/share/nym-vpn/app-data.toml.

The application will create a new one on startup.

Thread main panicked

If you see a message like:

thread 'main' panicked at /Users/runner/.cargo/git/checkouts/mullvadvpn-app-a575cf705b5dfd76/ccfbaa2/talpid-routing/src/unix.rs:301:30:

Restart your wifi connection and start again.

MacOS alert on NymVPN UI startup

If you are running NymVPN on mac OS for the first time, you may see this alert message:

  1. Head to System Settings -> Privacy & Security and click Allow anyway

  1. Confirm with your password or TouchID

  2. Possibly you may have to confirm again upon running the application