Portal Home > Knowledgebase > Tutorials / Guides > Apple MacOS X > OpenVPN for Apple MacOS (with Viscosity)

OpenVPN for Apple MacOS (with Viscosity)

Viscosity is a commercial software for connecting to proxy.sh OpenVPN tunnels that is available on Mac OS X. It works as an alternative to Tunnelblick.

Start by downloading the latest Viscosity release. If not done automatically, open the disk image and drag the Viscosity icon to your Applications folder.

Download *.ovpn files & proxysh.crt certificate from the link given in your welcome email or via your active VPN package product details (or you can use our configuration files generator), to your Downloads folder.

Now open Viscosity from the Applications folder by clicking on its icon.

Viscosity's menu bar item — a globe — has appeared. Click on it and select Preferences….

In the lower left corner of the Preferences window, there is a + button. When you click it, a pop-up menu appears. Select Import Connection/From File….

Navigate to the Downloads folder and select *.ovpn file. Click Open.

A dialog window informs that the connection has been imported. Click OK.

Back in Viscosity's Preferences, select the newly imported connection named Proxy.sh. Then click Edit.

You do not need to alter too many settings, because most of them are read from the configuration file. The settings are shown for completeness and comparison.

In the General tab, you confirm the Connection Name to Proxy.sh. Make sure to have Enable IPv6 unchecked. Click Authentication.

The Authenticion tab lists the authentication type and the used certificates. The certificates have been included in the already imported configuration file. If not, please select the proxysh.crt file that you previously downloaded. Click Options.

The Options tab deals with tunnel persistence, the peer certificate type and compression. It is important to have Pull Options checked, which is a default setting. Click Networking.

In the Networking tab, check Send all traffic over VPN connection and also Enable DNS support. Skip the Proxy and Advanced tabs, and Save.

Back in the Preferences window, switch to the General tab. For convenience, check Start Viscosity at Login. Switch to the Advanced tab.

In the Advanced tab, uncheck Accept IPv6 Router Advertisements. Have Allow unsafe OpenVPN commands to be used unchecked and close the Preferences window.

Click on Viscosity's globe icon in the menu bar, and select Connect Proxy.sh.

The following dialog asks for your Username and Password. Enter your VPN credentials here. Check Remember details in my Keychain to save your credentials. Click OK.

That's it. Enjoy!

NB: If you encounter difficulties to connect with OpenVPN, please try to connect to other servers or try alternative ports, especially more "discreet" ones such as TCP 443 or TCP 80. Please also make sure that the port you are connecting through is fully opened in your firewall/router/network. Below, you will find an aggregate of useful guides and articles that will help you troubleshoot your problems, should you have any.

Guide for setting up Safejumper (OpenVPN) on Apple MacOS.
I cannot find the .ovpn and .crt files necessary for OpenVPN. Where are they?
No matter how hard I try, I cannot succesfully connect to OpenVPN.
I can't access any website through my browser while connected to VPN.
I am connected to the VPN but my IP is not yet hidden. Help!
I am having some kind of other problem. Where can I find some help?
How can I find the local log files of my VPN client?

If you still cannot connect successfully, please open a support ticket and include either a copy of your logs or a screenshot of your configuration and encountered errors. Logs can usually be found in software menus or settings, as well as their directories of installation (.log or .txt files). If you do not include a log or a screenshot, it will be hard for us to help you resolve the issues you have with connecting to our network.
Related Knowledgebase Articles