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 called "Profiles".
7. Open the new Profiles 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.
   
   
   

Ordering of the connections is controlled by the "ConnectionOrder" preferences item. The order of connections can be controlled by opening the bundled preferences file in a text editor and editing the ConnectionOrder dictionary. For example, your bundled copy may simply contain something like so: