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

Discussion Group
  Read Before You Post

Auto-Install Configurations

This feature does not work on macOS Sierra and higher because of "Gatekeeper Path Randomization", also known as "app translocation" and may be removed from Tunnelblick in the future.

You can distribute Tunnelblick with configurations that will be installed automatically when Tunnelblick itself is installed. This does not require rebranding and uses a standard, digitally-signed Tunnelblick.app, however, it cannot update configurations the way that a Deployed version can.

When Tunnelblick installs itself, it looks for configurations to install in the "auto-install" and ".auto-install" folders that are in the same location as Tunnelblick.app.

  1. Create a Tunnelblick VPN Configuration (".tblk") for each configuration that you wish to distribute. As usual, the name of the .tblk will be what is displayed to the user as the name of the configuration. (You may create a folder structure that contains some or all of the configurations in subfolders, see Managing a Large Number of Configurations.)
  2. Create a folder, named "Configurations", and move all the Tunnelblick VPN Configurations into it. (Move the entire folder structure of configurations if you created one.)
  3. Rename the folder to "Configurations.tblk".
  4. Create a second folder, named "auto-install" and move "Configurations.tblk" into it. (Name the folder ".auto-install" if you want to hide it from your users.)
  5. Create a third folder, named "YOURNAME", and move "auto-install" or ".auto-install" into it.
  6. Download a Tunnelblick.dmg from the Tunnelblick Downloads page.
  7. Double-click the .dmg to open it, and drag the Tunnelblick icon into the "YOURNAME" folder to copy Tunnelblick.app (the Tunnelblick application) into that folder.

The "YOURNAME" folder now contains the following:
auto-install (or .autoinstall) folder

The auto-install (or .autoinstall) folder contains your configurations, perhaps in subfolders

Finally, create a .zip of the "YOURNAME" folder by control-clicking the "YOURNAME folder and clicking on "Compress YOURNAME". A "YOURNAME.zip" file will be created.

That "YOURNAME.zip" file is what users should download.

(Or you can create a .dmg that contains the contents of the "YOURNAME" folder. That's more complicated and not explained here.)


After downloading "YOURNAME.zip", users may need to double-click the .zip file to expand it (their browser may do that automatically).

A Finder window will appear with two items: Tunnelblick.app and a folder named "autoinstall". To start the process, they need only double-click Tunnelblick.app.

After finishing the installation, they may discard the "YOURNAME" folder and/or the "YOURNAME.zip" file if they wish.

  Deutsch     Français     中文(简体)     Русский     Español     日本語     …