App Support.

We're here to help.



Exporting and Distributing Connections

Viscosity allows connections to be easily exported and distributed to other users. Viscosity supports two types of connection formats (along with .conf and .ovpn configuration files):

  • .visc: These are the standard Viscosity connection file bundles. They contain a config file, along with any required certificate and key files. They are a Mac OS X bundle, which means while they appear to be a single file to Mac OS X users, they will appear as a file to Windows and Linux users.
  • .visz: These are an an alternative to the Viscosity connection file bundles, and are essentially a compressed copy of a .visc file (in .tar.gz format). They have the advantage that they will appear as a single file to all users, and can be easily emailed or stored on a web server.

A user can easily import either of these connection formats by simply double-clicking on them, or using the Import Connection menu in the Preferences window.

Exporting A VPN Connection

Viscosity can automatically create either of the above connection formats for you like so:

  1. Open Viscosity's Preferences window
  2. Select the connection you wish to export
  3. Click on the Utilities drop-down menu (the button next to the left of the Edit button) and select "Export Connection" to create a .visc connection file, or "Export Zipped Connection" to create a .visz connection file.


  4. Select a location to save the file to and then click the Save button

Creating a Connection File Manually

It is also relatively easy to create Viscosity connection files manually, or write a script to automatically generate them. Viscosity standard connection file bundled (.visc) have the following restrictions:

  • Bundle name must be a folder ending in .visc
  • The folder must contain an OpenVPN configuration file named "config.conf"
  • All certificates, keys, and other files referenced in the configuration file must also be present in the folder. These files should be referenced locally in the config file (i.e. no absolute paths)

Viscosity supports a number of extended options that can be inserted into OpenVPN configuration files, including:

  • #viscosity startonopen value
Value/s: true, false
Description: Controls whether the connection will be automatically connected when Viscosity is opened.
  • #viscosity dhcp value
Value/s: true, false
Description: Controls whether DHCP support will be enabled for the connection if it is TAP based. This value defaults to true for TUN connections.
  • #viscosity dnssupport value
Value/s: true, false
Description: Controls whether Viscosity's DNS support is enabled for the connection.
  • #viscosity name value
Value/s: A string value. Spaces and UTF8 characters are allowed.
Description: The name of the connection as it appears in Viscosity.
  • #viscosity ipv6 value
Value/s: true, false
Description: Controls whether IPv6 support will be enabled for the connection if it is TAP based. This value defaults to false for TUN connections.

A zipped connection file (.visz) can be created by simply zipping a .visc bundle file, and renaming it to .visz.