On This Page
Tunnelblick is an interface for OpenVPN. Most problems people think they have with Tunnelblick are really problems they are having with OpenVPN, so what follows is a mix of information about Tunnelblick and OpenVPN.
OpenVPN is such a powerful tool with so many options, and computer configurations are so varied, that it is difficult to have an exhaustive guide to troubleshooting problems. Tunnelblick is designed to deal easily with the most common setups, so if it doesn't apply to your situation, or doesn't help, ask the Tunnelblick Discussion Group or the OpenVPN users mailing list for help.
I used a different program and uninstalled it, but with Tunnelblick all I can see are my old configurations!
The different program (for example, Urban Shield) uses a customized version of Tunnelblick that makes backups of their configurations and restores them when Tunnelblick starts up, and also hides all other configurations. To solve this problem:
How can you tell if OpenVPN connected to a server?
If OpenVPN is not connected to the server
If OpenVPN can't connect to the server and Tunnelblick hasn't popped up a window explaining why, there should be one or more error messages in the OpenVPN log to indicate what the problem is. To see the OpenVPN log, click on the Tunnelblick icon, click on "VPN Details", click on the large "Configurations" button at the top of the window, click on the name of the configuration you are troubleshooting on the left side of the window, and then click on the "Log" tab on the right side. The OpenVPN log is the large area of black text on a white background. (It contains messages from Tunnelblick in addition to the messages from OpenVPN.)
Look at lines near the end of the log for an error message.
OpenVPN Connects, but you can't surf the Internet
See Connects OK, But....
A connection is established, but drops out or is restarted after a few seconds or minutes, or DNS stops working after a few minutes
This can have several causes:
An error messages says to see details in the Console Log
See The Console Log for instructions on viewing the Console Log.
An error message says "write to TUN/TAP : Input/output error (code=5)"
OpenVPN may display a series of these messages when using a TAP connection. Although a few such messages are normal, if they continue to be displayed for more than a few seconds and the connection is never established, try to connect with DNS/WINS set to "Set nameserver (alternate 1)".
An error message says "You have tried to connect using a configuration file that is the same as the sample configuration file installed by Tunnelblick"
This means that you have tried to connect to a VPN without setting up a configuration file. Consult your network administrator or your VPN service provider to obtain configuration and other files or the information you need to modify the sample file. For more information, see Getting VPN Service.
An OpenVPN log entry says "potential route subnet conflict"
This means that the remote network you are creating a VPN to has IP addresses that are also in your local LAN.
One way to fix this is to include a "redirect gateway local" option in the OpenVPN configuration file and un-check Tunnelblick's "Route all IPv4 traffic through the VPN". (All traffic will still be routed through the VPN because of the "redirect gateway" option.)
Another way to fix this is to change the addresses of your local LAN. You do this by changing your router's configuration. For some routers you specify the first three numbers of the LAN (e.g. 192.168.77); in other routers you specify the address of the router itself (e.g. 192.168.77.1).
After changing the LAN address, you should restart all computers (and other network devices including network printers), so they start using addresses in the new address range.
This means that both the remote network and your local network are using the 192.168.1.
An OpenVPN log entry says "Cannot allocate TUN/TAP dev dynamically"
This problem indicates a problem with the Tun and/or Tap system extensions.
An error message says "Tunnelblick was not able to load a device driver (kext) that is needed to connect..."
An OpenVPN log entry says "Tunnelblick: openvpnstart status #247: Error: Unable to load tun and tap kexts. Status = 71"
An OpenVPN log entry says "Tunnelblick: openvpnstart status #247: Error: Unable to load net.tunnelblick.tun and/or net.tunnelblick.tap kexts in 5 tries. Status = 71"
Please see Errors Loading System Extensions.
An OpenVPN log entry says "Note: unable to redirect default gateway -- Cannot read current default gateway from system"
There is a problem (in macOS and/or OpenVPN) which causes OpenVPN to be unable to read the default gateway when you try to connect OpenVPN through an existing PPP connection; here is a workaround:
An OpenVPN log entry says "Cannot load certificate file XXX.crt: error: 02001002:system library:fopen:No such file or directory: error: 20074002:BIO routines:FILE_CTRL:system lib: error:140AD002:SSL routines"
Your certificate file (XXX.crt) was not found. Usually the file should be in the same folder as the OpenVPN configuration file, not in a subfolder. For example, if the configuration file has a line such as
An OpenVPN log entry says "TLS Error: Auth Username/Password was not provided by peer"
Your client configuration file should include an "auth-user-pass" option.
An OpenVPN log entry says "script failed: could not execute external program"
An up or down script contains an error. Common causes:
Cannot Empty the Trash
If you dragged an old copy of Tunnelblick to the Trash and now cannot empty the Trash and because Finder complains that something is "in use" (probably something named Sparkle.framework), try the following:
Launch Terminal (in /Applications/Utilities).
Copy/paste the following into Terminal:
You will be asked for your password. Type it in (it will not show up as you type it) then press the "enter/return" key on the keyboard.
Quit Terminal, then try to empty the Trash.
I am repeatedly asked for my password or token value (Tunnelblick 3.6.9beta02 or higher)
For some OpenVPN setups that use "small block" ciphers and username/password authentication or two-factor authentication (2FA), this can be very annoying because the user will be asked to authenticate each time 64 MB has been transferred through the VPN.
There are several ways to avoid the problem:
More information is available at OpenVPN and SWEET32.