Viscosity can be bundled ("pre-configured") with preferences and registration information so the user doesn't need to setup Viscosity themselves. Any preferences option Viscosity supports can be bundled into the Viscosity application.

Bundling Viscosity With Preferences

The simplest way to bundle Viscosity with preferences is like so:

1. Download the latest version of Viscosity
2. Drag Viscosity from the downloaded disk image to your Applications folder.
3. Drag Viscosity from the downloaded disk image to your Desktop as well. We'll be bundling Preferences data into this copy.
4. Open the copy on Viscosity in your Applications folder. Configure it with the preferences you wish deployed versions to have. If you wish to bundle Viscosity with a license key make sure you register Viscosity from the Preferences->About section using your license details.
5. Using the Finder, go to your Your Home Folder/Library/Preferences
6. Control-click (or right-click) on the "com.viscosityvpn.Viscosity.plist" file and then select "Copy com.viscosityvpn.Viscosity.plist"
   
   
   
7. Using the Finder, Control-click (or right-click) on the copy of Viscosity on your Desktop (not the copy in your Applications folder) and select "Show Package Contents".
   
   
   
8. Open the "Contents" folder, and then create a new folder named "Preconfigure". Open the new Preconfigure folder and then select Paste from the edit menu.
9. (Optional) Open the new com.viscosityvpn.Viscosity.plist file in a text editor and edit as desired.
10. Select the new com.viscosityvpn.Viscosity.plist file and select "Get Info" from the File menu. Expand the "Sharing & Permissions" section, and change each Name to "Read & Write". Close the window.
11. It is recommended you zip up Viscosity (control-click on Viscosity and select "Compress Viscosity"). You can now distribute this to other users.
    
    
    

Bundling Viscosity With VPN Connections

If you also want to bundle Viscosity with VPN connections following the steps below. The following steps assume you have already bundled Viscosity with a preferences file. If you only want to bundle Viscosity with connections, follow steps 1 to 3 in the section above to make separate copies on Viscosity, and then following the steps below.

1. Open the copy on Viscosity in your Applications folder and create the connections you wish to bundle with Viscosity
2. Using the Finder, go to Your Home directory/Library/Application Support/Viscosity/OpenVPN
   
   
   
3. You should see a directories listed by number (one for each connection). Select these and then select "Copy Items" from the Edit menu.
4. Using the Finder, Control-click (or right-click) on the copy of Viscosity on your Desktop (not the copy in your Applications folder) and select "Show Package Contents".
   
   
   
5. Open the "Contents" folder, and then create a new folder named "Preconfigure" (if you haven't already done so).
6. Open up the newly created "Preconfigure" folder and create another folder with one of the following names (depending on the behaviour you desire):
   1. "Connections": If Viscosity already contains connections with the same name as connections in this folder, the user will be prompted with the choice to to overwrite those connections, or for them to be appended with an altered name (for example "My Connection 1" instead of "My Connection"), or not import them at all.
   2. "Connections-Overwrite": Connections in this folder will overwrite connections of the same name already listed in Viscosity. For example, if the user already has a connection named "My Connection", and there is a bundled connection named "My Connection", the existing connection will be deleted and the bundled connection imported. If a connection of that name doesn't already exist a bundled connection will be imported normally.
   3. "Connections-Append": Any connections in this folder will be automatically appended to the user's existing connections. If a connection already exists with the same name as a bundled connection, the bundled connection will be imported using an alternate name (for example "My Connection 1" instead of "My Connection").
7. Open the new folder and select Paste from the edit menu to copy the connections in.
8. It is recommended you zip up Viscosity (control-click on Viscosity and select "Compress Viscosity"). You can now distribute this to other users.
   
   
   

Connection Ordering

The order connections appear in Viscosity's menu can be controlled by their directory file names: Viscosity will process them in alphabetical order. By default the connections in your connections directly above will have names like "1", "2", "3", etc., however these can be named anything. For example, you may like to call the connection you want to appear at the top of the list "a", the connection under it "b", the connection under that "c", and so on.

If you are also bundling Viscosity with a preferences file (as outlined above) it is recommend the "ConnectionOrder" key and associated array be removed from the file to avoid connection ordering conflicts.

Connection Folders

As well as controlling the order connections appear in, you can also organise them into sub-directories, which will appear as folders in Viscosity's menu. For example, if you have two office locations, and you have 6 connections you wish to be grouped into folders for each location, your bundled connection folder might look something like:

The folder created in Viscosity's menu will have the same name as the directory.