tunnelblick icon Tunnelblick free software for OpenVPN on OS X and macOS We need translators for several languages…
Home Downloads Support Documents Issues Source Contribute Contact

Highlighted Articles
  Installing Tunnelblick
  Uninstalling Tunnelblick
  Setting up Configurations
  Using Tunnelblick
  Getting VPN Service
  Common Problems
  Configuring OpenVPN
  Release Notes
  Thanks
  FAQ

Discussion Group
  Read Before You Post

Converting a Deployed Version of Tunnelblick to a regular Version

On This Page
    Why You May Want to Do This
    How To for Experts
    How To for Everyone Else


Why You May Want to Do This

The latest versions of Tunnelblick include important security changes. These changes modified the way that "Deployed" versions of Tunnelblick are created and are difficult for some VPN service providers to implement, so some of them continue to supply old "Deployed" versions to their users.

If you are using such an older "Deployed" version of Tunnelblick, you may want to convert to using a non-Deployed version so that you can use the latest versions of Tunnelblick which include the security changes.

Note: Installing a Deployed version of Tunnelblick will "poison" an already-installed "regular" version. If you do so, it will be necessary to follow these instructions again, especially the "completely uninstall Tunnelblick" part of the instructions.

If you are a VPN service provider distributing older Deployed versions of Tunnelblick, you may want to update them or change to using "automatically installed" configurations with a regular version of Tunnelblick. See Distributing Tunnelblick for details.


How To for Experts

  1. Copy (do not move)
    Tunnelblick.app/Contents/Resources/Deploy
    to the Desktop.
  2. Completely uninstall Tunnelblick.
  3. Install the latest version of Tunnelblick from Tunnelblick Downloads. Launch Tunnelblick and proceed normally; quit when you are asked about configurations
  4. Copy the contents of the Deploy folder (not the folder itself) on the Desktop into
    ~/Library/Application Support/Tunnelblick/Configurations (note the "~")
  5. Launch Tunnelblick and allow the configurations to be converted.
  6. Enjoy!

How To for Everyone Else

You can use the following instructions to convert from using a Deployed version of Tunnelblick to using a "regular" version. These are extremely detailed, click-by-click instructions:

  1. Extract the configurations from the Deployed version of Tunnelblick and save them:
  2. Find the copy of Tunnelblick.app that you are using. It may be in /Applications, but older versions of Tunnelblick (before version 3.3beta22) can be installed anywhere.
  3. Control-click (hold down the "control" key on the keyboard and click) on Tunnelblick.app and select "Show Package Contents". A new Finder window will appear with the single folder "Contents".
  4. Double-click on "Contents", and the window will change to include several items.
  5. Double-click on "Resources", and the window will change to include many items (usually more than 70)
  6. Find the folder named "Deploy" and Option-drag it to an empty space on the Desktop (that is, drag the folder while holding down the "option" key). This will create a new copy of the folder on the Desktop.
  7. Completely uninstall Tunnelblick, using the instructions at Uninstalling Tunnelblick. <== CRITICAL
  8. Install a recent version of Tunnelblick:
  9. Download a new version of Tunnelblick from Tunnelblick Downloads.
  10. Install it by double-clicking on the "Tunnelblick.app" icon. (Depending on your browser, you may need to find and double-click on the downloaded Tunnelblick.dmg file first.)
  11. When asked for your username and/or password, provide your computer administrator username/password, not your VPN password.
  12. Answer the questions about updating Tunnelblick and checking for IP address changes as you wish.
  13. Quit Tunnelblick when you are asked a question about configurations.
  14. Prepare to use the saved VPN configurations you saved in step 1.
  15. Open the user's "Library/Application Support/Tunnelblick/Configurations" folder:
  16. Open a new Finder window.
  17. Hold down the "option" key on the keyboard and click on the "Go" menu item. Keeping the "option" key held down, click on "Library", then release the "option" key. The Finder window will change to show the "Library" folder.
  18. Double-click the "Application Support" folder.
  19. Double-click the "Tunnelblick folder".
  20. Double-click the "Configurations" folder. The window should be empty because there are no configurations.
  21. Double-click the "Deploy" folder on your Desktop. A Finder window will appear with the files and folders that contain your VPN configurations.
  22. Option-drag everything in that window to the empty "Configurations" Finder window.
  23. Convert the OpenVPN configurations to be Tunnelblick VPN Configurations:
  24. Launch Tunnelblick. You will be asked if you want to convert the configurations. Click the button to "Convert".
  25. (There is no step 2!)
  26. Enjoy!
  Deutsch     Français     中文(简体)     Русский     Español     日本語     …