App Support.

We're here to help.


Using Viscosity

Viscosity has many different options to control and customise the way your connections operate, as well as how Viscosity displays information and how it looks. All of these options are available in the Preferences window which can be accessed via clicking the Viscosity icon on your Menu Bar (Mac) or in the System Tray or Notification Area (Windows).

We recommend reading through Getting Started With Viscosity (Mac) or Getting Started With Viscosity (Windows) before this article.

Some options may be only available for Mac or Windows, these options are indicated where applicable.

General

  • Start Viscosity at Login - Enable to start Viscosity when you login to your computer.
  • Reconnect active connections on wake - If connections drop out while your computer is asleep, Viscosity will reconnect them automatically when your computer wakes up.
  • Disconnect connections after X minutes of inactivity - If your computer is unused for a certain number of minutes, Viscosity will disconnect any active connections.
  • Automatically check for updates - Automatically check for Viscosity updates. This check takes place once every 24 hours.
  • Check Now - Click to force a check for a Viscosity update. If Include Beta versions is enabled, this check will include beta versions.
  • Include beta versions - Include beta versions in any update checks. Please see Using Viscosity Beta Versions for more information.
  • Import OpenVPN Connections (Windows Only) - Viscosity will check for and import any OpenVPN connections it finds in the default location (C:\Program Files\OpenVPN\Configs) on your PC.
  • Import Tunnelblick Connections (Mac Only) - Viscosity will check for and import any Tunnelblick connections it finds on your Mac.

Appearance

  • Menu Icons - Change the display of the menu icons in your Menu Bar or Notification area. You can sometimes find extra menu packs on your Forums in the Goodies section.
  • Display IP address in menu - Displays the Local IP address of your VPN connection in the Viscosity Menu when a connection is connected.
  • Details window is always on top - Change this option to select whether the Details window will appear on top of other windows.

Advanced

  • Use single network adapter for all connections (Windows Only) - Please see Single Adapter Mode (Windows) for more information
  • Create VPN network adapter on import (Windows Only) - Creates a network adapter for the connection when it is imported. If this option is not enabled, a network adapter is instead created the first time the connection is connected. If you would like to import a large number of connection into Viscosity, we recommend you disable this option.
  • Reset network interfaces on disconnect - Resets every adapter on your Mac or PC when a VPN connection disconnects. This may help if you are having connection issues after a VPN connection is disconnected.
  • Automatically disable DHCP when not needed (Mac Only) - When using TAP connections your client IP can come either from the OpenVPN server or from a remote DHCP server. However using DHCP when it's not needed can potentially cause problems due to a self-assigned or multiple IP addresses being used. This option will automatically turn off DHCP if its not needed for TAP connections.
  • Keep original certificate/key names on import - Viscosity will rename your certificates and keys for connections when you import a connect by default to generic names which will not cause any compatibility issues with connections. If you wish for this not to happen, enable this option.
  • Allow unsafe OpenVPN commands to be used - Allows dangerous OpenVPN commands or options to be used. This option requires Administrator rights to enable. Please see Error: Unsafe OpenVPN command detected for more information.
  • OpenVPN Version - When major OpenVPN updates are released, older versions are sometimes retained in Viscosity for connecting to older servers, you can change versions here if they are available, otherwise Automatic will allow Viscosity to select the best version for your configuration.
  • Clear All Saved Credentials (Windows Only) - Clears all saved login credentials for all connections. Can be useful for troubleshooting connection issues.

About

The About tab displays information about Viscosity. Here you will see the version of Viscosity you are using, as well as useful links, credits and legal information.

If you are still trialling Viscosity and choose to purchase a license, it can be entered here by pressing the Register button, or you can click Purchase License to be taken to our store. Fore more information on registering Viscosity, or if you are having problems, please take a look at Registering Viscosity.

If Viscosity is already registered, you will see your registered name for the license you are using here instead.