VPNUK - The Virtual Private Network Specialists

Mac OSX Tunnelblick / OpenVPN Setup

Tunnelblick is a simple graphical user interface for the VPN software OpenVPN and higher. It is written in Cocoa and comes in a ready to use distribution with all necessary binaries and drivers.

Part 1 - Setting up the VPNUK config file(s)

1. Download the config files
Download VPNUK config files for use with Tunnelblick from here and extract the folder called 'config' to your desktop:

UDP & TCP Config Files (recommended) - Download Now
UDP Config Files - Download Now
TCP Config Files - Download Now

2. Open the config file(s)
Double click onto the 'config' folder to open it.

2. Open the .ovpn file(s)
You now need to make a small edit to the '.ovpn' config file(s). Double click onto the file or files you'd like to edit.
Notes:
1. If you have downloaded the UDP and TCP config files you will have two files named: tcp.ovpn and udp.ovpn, you will need to edit both.
2. You can setup connections to multiple servers by creating more .ovpn files, all you have to do is change the IP of the server.

3. Edit the config file(s)
There is one small edit required to line seven of the config file, you need to change the words 'INSERT-IP-ADDRESS-HERE' to the VPNUK server IP you are connecting to.

4. Save the config file
You can now save and close the config file if prompted.

Part 2 - Installing Tunnelblick

1. Download Tunnelblick
You can download the latest stable release for OS X 10.4, 10.5 10.6 and 10.7 from the Tunnelblick project page here: http://code.google.com/p/tunnelblick/wiki/DownloadsEntry

2. Begin the installation process
Double click the downloaded .dmg file. An icon for a 'Tunnelblick' will appear on the desktop and a window similar to the following will open. Double click the Tunnelblick.app icon.

3. Confirm install
Click the 'Install' button to copy Tunnelblick to your hard drive.

4. Installation complete
Once installation has completed a new window will appear, click the 'Launch' button.

5. Tunnelblick Configurations
Tunnelblick will now ask you if you have a configuration file, select the button that reads 'I have configuration files'.

6. Type of Configurations
Click onto the button that reads 'OpenVPN Configurations'.

7. Open Configurations Folder
Click onto the button that reads 'Open Private Configurations Folder', the folder will then open read for you to insert the VPNUK configuration files into.

Part 3 - Configuring Tunnelblick

1. Open the config files
Double click onto to the 'Config' you downloaded earlier to display the files.

3. Insert the config files
Drag the VPNUK config files out of the config folder, into the Configurations folder. You can also delete any sample configuration files that already exist in the Configurations folder. All you need to have in the Configurations folder are the VPNUK config files and possibly a Launch Tunnelblick shortcut.

4. Create a Shortcut (Optional)
Drag the 'Launch Tunnelblick' shortcut file to the desktop if you would like to create a Tunnelblick shortcut. You can now close the 'config' and 'Configurations' windows.

Part 4 - Running Tunnelblick

1. Launch Tunnelblick
To launch Tunnelblick, double click the 'Launch Tunnelblick' shortcut on the desktop or double click 'Tunnelblick' from within the Applications folder.

2. Tunnelblick launched
Tunnelblick will launch in the menu.

3. Connect to VPNUK through Tunnelblick
Click onto the Tunnelblick icon and select 'Connect'. You can also click 'Details' for a more detailed view of the connection procedure.

3. Connected!!
When the Tunnelblick icon changes to a tunnel you are connected.

[END]

VPNUK Configuration Files
UDP & TCP Config Files (recommended) - Download Now
UDP Config Files - Download Now
TCP Config Files - Download Now

Optional Settings and Configuration

Connecting to multiple VPNUK servers
You can put more than one .ovpn file into the Configurations folder. Tunnelblick interprets each .ovpn file in the Configurations folder as a configuration file for a different connection; each of the connections will be available in the drop down menu and shown as a separate tab in the 'OpenVPN Log' window.

Automatically starting Tunnelblick upon login
Tunnelblick was designed as a persistent menu icon that survives reboots. To this end, it inserts itself into the login items when it is started and only removes itself from the login items when you choose Quit from the menu or Command-Q from the 'OpenVPN Log' window. So if you just log out, shut down, or restart your computer, or it crashes, the next time you log in, Tunnelblick will automatically start. If you do not want Tunnelblick to start automatically, quit Tunnelblick before you log out, shut down, or restart.

Automatically opening a VPN Connection when Tunnelblick starts
You can specify that a connection automatically be opened when Tunnelblick starts by putting a check in the 'Automatically connect on launch' checkbox for that connection. The checkbox is located on the connection's tab in the 'OpenVPN Log' window.

Uninstalling Tunnelblick
To uninstall Tunnelblick, move Tunnelblick.app from the Applications folder to the Trash. Other than the preferences and configuration files described in "File Locations", there are no other files installed -- OpenVPN, the tun/tap kernel extensions, and up/down scripts are contained within the Tunnelblick.app package and are loaded only when needed directly from there. Tunnelblick may store passphrases or passwords in the Keychain at the user's request.