App Support.

We're here to help.



Getting Started With Viscosity (Mac)

This guide is designed to get you started using Viscosity in the fastest way possible. If you require more detailed instructions, walkthroughs, or troubleshooting information please refer to other Knowledge Base articles.

Installing & Running Viscosity

Before you can use Viscosity it must first be installed using the instructions below. You must have administration rights on your computer to be able to install Viscosity.

Installing Viscosity

  1. Open the Viscosity.dmg file (usually located in your Downloads folder) by double-clicking it.
  2. Drag Viscosity to your Applications folder.
  3. Eject the Viscosity disk image.


Running Viscosity

  • Launch Viscosity from your Applications folder.


  • Enter your username and password so Viscosity can configure itself and install any necessary components.

Your VPN Provider

Viscosity allows you to connect to any VPN server that supports the OpenVPN protocol. Viscosity is only one end of the VPN connection: your VPN provider provides the other end of the connection (the server you wish to connect to). Your VPN Provider is the person or company who controls this server.

Typically your VPN provider falls into one of the following categories:

  • Workplace: Your workplace may provide a VPN server so you can remotely and securely access the work network and Internet. In most cases the person to contact for more information or connection details would be your IT/System Administrator.
  • VPN Service: Many third party companies specialize in offering both free and paid VPN services to users. There are a number of reasons why you may want to subscribe to a VPN Service, including protecting your privacy and security while on public networks, accessing location restricted websites, and accessing blocked content due to restrictive censorship. Most VPN Service providers provide a webpage or support site where you can obtain connection details. A list of VPN providers with Viscosity setup guides can be on our VPN Service Providers page.
  • Personal: If you are familiar with VPNs you may have setup your own OpenVPN server so you can access your home network, and/or to have the same benefits as using a VPN Service Provider.

It is important to identify who your VPN provider is and obtain the details you need to setup your connection. Your VPN provider may provide you with the settings and files you need to manually enter into Viscosity, or a configuration file Viscosity can automatically import (see below).

In addition many workplaces and VPN Service providers provide customized versions of Viscosity that already contain all of your connections, allowing you to skip the steps below. You may like to check with your VPN Provider to see if they offer this.

Creating Your First Connection

You can create a connection in Viscosity by manually configuring a connection, or by importing a connection from a bundle or OpenVPN configuration file.

Importing A Connection

You can import a connection into Viscosity by double clicking on a Viscosity connection bundle or OpenVPN configuration file, or by following the steps below:

Step 1

Open Viscosity, go to the Viscosity menu and select “Preferences…”.The preferences window should appear.



Step 2

Make sure the “Connections” toolbar item is selected, and then click the “+” button in the bottom left hand corner of the window. Select “Import Connection” then "From File..." from the menu that appears.



Step 3

Select the connection bundle (.visc) or OpenVPN configuration file (.ovpn or .conf) supplied by your server administrator. Click the Open button.


Step 4

Your connection will now appear in the Viscosity menu. To connect, select your connect from the menu. The menu icon will update to let you know when your new connection has connected.


Manually Creating A Connection

You can manually create a new connection in Viscosity using the instructions below. You'll need to obtain the necessary settings and any certificates/keys from your VPN provider.

Step 1

Open Viscosity, go to the Viscosity menu and select “Preferences…”. The preferences window should appear.


Step 2

Make sure the “Connections” toolbar item is selected, and then click the “+” button in the bottom left hand corner of the window. Select “New Connection” from the menu that appears.


Step 3

Give your connection a name, which can be anything you want. In the Address field enter the address of the OpenVPN server. Change the port if the server doesn’t used the default value. Select the protocol and device that matches the OpenVPN server’s settings.


Step 4

Click on the “Authentication” tab. From the Authentication Type menu select the authentication type your OpenVPN server requires. Different options will be displayed depending on the type. To use multiple authentication types, simply select each type in turn from the menu and configure it. Most fields require you to select a certificate or key file. Your server administrator should have provided you with these if required. To specify a file, click the “Select…” button, locate the file, and click Open.


Step 5

Use the tab bar to configure the remaining sections (Options, Networking, Proxy, and Advanced) as required. In most cases the default settings will work. If your server requires you to enter a username and password to connect, make sure you tick the “Use Username/Password Authentication” checkbox under the Options tab. Click the Save button when finished.


Step 6

Your connection will now appear in the Viscosity menu. To connect, select your connect from the menu. The menu icon will update to let you know when your new connection has connected.


Using Viscosity

The following sections provide a brief overview of Viscosity's interface and options.

The Viscosity Menu

The Viscosity menu is the main way of interacting with Viscosity and your connections. The Viscosity menu can be found at the top right hand corner of your screen (near the clock). Clicking on the icon once will bring up the menu.


The Viscosity menu allows you to connect or disconnect a connection by selecting it from the menu, open Viscosity's Preferences window, open Viscosity's Details window, and to quit Viscosity. Your connections will be automatically disconnected when Viscosity quits.

Please note that by default Viscosity does not appear in the dock.

The Details Window

The Details window allows you to monitor your VPN connections. If you wish to check the status of a connection, experience trouble connecting, you should first check the details window for information. The Details window has three main sections, as outlined below. You can switch between these sections by clicking on the relevant buttons near the middle of the window.


  • Traffic Graph: The traffic graph will graph network traffic for the last 60 seconds. It will automatically scale to match the maximum traffic rate. The vertical axis on the left will list the range of data rates, while the In/Out values list the current data rate of traffic passing through the VPN connection.
  • Traffic: The traffic section lists total data amounts that have passed through the VPN network adapter. These values are reset each time the connection is re-established.
  • Log: The log section displays the OpenVPN log output. The log will contain important information if you are having trouble connecting.

The Preferences Window

Viscosity's Preferences window allows you to access and edit your VPN connections, as well as change Viscosity's overall settings. The toolbar at the top of the window can be used to navigate between the following sections.


  • Connections: The Connections area allows you to manage your VPN connections. Use the "+" button to add new connections, the "-" button to remove a selected connection, and the "Edit" button to edit a selected connection.
  • General: The General area allows you to modify general global preferences, including automatic update settings.
  • Appearance: The Appearance area allows you to change the look and feel of Viscosity, including the menu bar icons and the behaviour of the Details window.
  • Advanced: Settings in the Advanced area should only be changed by advanced users. This area allows you to change the OpenVPN version Viscosity uses, as well as options to aid troubleshooting.

For full information regarding the options available please see the Using Viscosity and Connection Settings articles.