Before You Post About a Problem

Problems with Tunnelblick can be either:

• Posted to the Tunnelblick Discussion Group.
• Posted as a Tunnelblick Issue on GitHub; or

First, please search the Internet, the discussion group, and/or the Tunnelblick GitHub Issues for the problem.

Posting to the Tunnelblick Discussion Group

If you are a member of the group, your first post must be approved by a moderator before it will appear.

If you are not a member of this group, each of your posts must be approved by a moderator before it will appear.

Please be patient — we're all volunteers!

Posting a Tunnelblick Issue on GitHub

You must log into GitHub to post an Issue or reply to an existing issue on GitHub.

How and What to Post

If you are having a problem with Tunnelblick, please:

Please try the latest "beta" version of Tunnelblick -- beta versions usually include fixes to problems that are not available in the stable release version.

This procedure may fix the problem you are having. Even if it doesn't, it creates the information usually needed to diagnose problems:

1. Open Tunnelblick's "VPN Details" window.
2. On the "Preferences" panel, please click the button to "Reset Disabled Warnings".
3. On the "Configurations" panel, please select the configuration you want to connect in the list on the left.
4. Click on the "Settings" tab.
5. Make sure that "Set DNS/WINS" is set to "Set nameserver". This is the default setting and enables useful extra logging.
6. Make sure that "VPN log level" is set to "OpenVPN level 3 - normal output". This is the default setting; higher levels are for debugging OpenVPN itself and is almost never needed and usually makes it harder to find the cause of a problem.
7. Make sure that "Check if the apparent public IP address changed after connecting" is checked.
8. Click on the "Log" tab.
9. Click on the "Connect" button.
10. Wait until the problem occurs. If the problem is that no connection is made, wait at least 70 seconds.
11. If you can, click on the "Disconnect" button and wait until the disconnection is complete. If the disconnection is not complete within 20 seconds, continue anyway.
12. Click on the "Copy Diagnostic Info to the Clipboard" button.
13. Wait for the copy to complete (there is a spinning progress indicator; when it disappears the copy is complete).
14. Close Tunnelblick.
15. Paste into a text file and add the file as an attachment to

• A new post on the Tunnelblick Discussion Group;
• A reply in an existing discussion);
• A new Tunnelblick Issue on GitHub; or
• A reply to an existing Tunnelblick Issue on GitHub.

Although the diagnostic info does not include encryption keys and certificates or passwords, you may want to examine it and obscure or remove anything you consider sensitive before sending.