Setting Up a VPN Connection on Your Device


Our main priority is to ensure the safety and security of the server infrastructures we manage. We have taken steps to protect our development resources by isolating them in private cloud segments that are separate from the public internet. This helps us avoid potential threats and prevent common attack methods. To access these resources, you will need to establish a secure VPN connection between your device and a VPN gateway in the cloud.

This guide provides instructions for setting up a VPN connection on different devices and platforms.
Important Note: Please note that when you use a VPN connection, all of your internet traffic goes through the VPN gateway in the cloud infrastructure. Streaming HD videos and using torrents can consume a lot of bandwidth on the development network and increase the monthly cost of the cloud resources. Therefore, remember to disable the VPN connection when you are streaming videos or using torrents.

Choose Your VPN Client Thinking Face

There are different VPN clients available for setting up a VPN connection. Some are more reliable and user-friendly than others. Depending on your device and platform, here are our recommended VPN clients for you:
Platform
VPN Client
Website
Windows
 OpenVPN Connect⁠ 
Icon for https://openvpn.net/client/client-connect-vpn-for-windows/
OpenVPN Connect - Client Software For Windows | OpenVPN
MacOS
 Tunnelblick⁠ 
Icon for https://tunnelblick.net
Tunnelblick | Free open source OpenVPN VPN client server software for macOS
Linux
OpenVPN 3 Linux
Icon for https://openvpn.net/openvpn-client-for-linux/
OpenVPN Client For Linux | OpenVPN
ChromeOS
OpenVPN Connect
Icon for https://play.google.com/store/apps/details?id=net.openvpn.openvpn
OpenVPN Connect – OpenVPN App - Apps on Google Play
iPhone iOS
OpenVPN Connect
Icon for https://itunes.apple.com/us/app/openvpn-connect/id590379981?mt=8
‎OpenVPN Connect – OpenVPN App
Android
OpenVPN Connect
Icon for https://play.google.com/store/apps/details?id=net.openvpn.openvpn
OpenVPN Connect – OpenVPN App - Apps on Google Play

Tunnelblick Metro

 Tunnelblick  is a free software that helps you manage VPNs on macOS. It prioritises its users and does not have any ads, affiliate marketers, or tracking. They also do not store logs of your IP address or other information.

Setting Up a VPN Connection on macOS with Tunnelblick

Follow these steps to set up a VPN connection on macOS using Tunnelblick:
     Download  and install the latest stable version of Tunnelblick on your Mac.
    Double-click the provided OpenVPN configuration file with the extension .ovpn.
    In the Install Configuration for All Users dialog box, click the Only Me button.
    Enter your system username and password if required.
    If it prompts you about having configuration files, select the option that says you have them ("I have configuration files"):
    Open the .ovpn configuration file you received in the file dialogue window.
    Make sure you are using OpenVPN version 2.5.0 or newer:
    To resolve the private DNS names with Tunnelblick:
  • Select Settings and then Advanced...
  • Select the checkbox for Allow changes to manually-set network settings.
    Click the Tunnelblick icon in the menu bar (top-right corner of your screen) and select Connect (.ovpn file name should be here).
    To disconnect from the VPN, click Disconnect (.ovpn file name should be here).

Troubleshooting

I am unable to resolve the private DNS names with Tunnelblick

Cause: When connecting to VPN, it refuses to set DNS servers with this warning:
Solution:
    Select Settings and then Advanced...
    Select Allow changes to manually-set network settings.

OpenVPN Connect Electric Plug

OpenVPN Connect is the official VPN client developed by OpenVPN Technologies Inc. It is designed to provide a secure internet connection for users by creating encrypted tunnels between devices. This helps keep data traffic confidential and protected from eavesdroppers and threats. OpenVPN Connect is compatible with various platforms, including Windows, Linux, macOS, iOS, ChromeOS, and Android. It is widely used for its reliability, strong security features, and open-source nature. Businesses and individuals choose OpenVPN Connect to maintain their digital privacy and security when accessing the internet, especially on unsecured networks like public Wi-Fi.

Installing and configuring OpenVPN Connect on Windows

    Download the  OpenVPN Connect Client  installer for Windows and follow the installation wizard steps to install the application. If you encounter any issues, please refer to the  installation instructions .
    Right-click on the OpenVPN GUI icon on your desktop and select Run as administrator. The application will run in minimized mode.
    Right-click on the OpenVPN GUI icon in the system tray (bottom-right corner of your desktop), then click on the Import Configuration option in the menu that appears. Choose the provided configuration file and click the Open button.
    Check the compression settings: Settings → Allow Compression → Full.
    Right-click on the OpenVPN GUI icon in the system tray and select Connect.

OpenVPN on Chromebook
    Install OpenVPN App for Android from Playstore.
    Launch the OpenVPN for Android.
    Select Import profile from .ovpn file.
    Navigate to the location of the .ovpn file.
    Tap the created profile to connect to VPN.
 Related documentation  on the official Chromebook help (see Android VPN apps section).

OpenVPN on Android
    Install  OpenVPN app  for Android from Google Play.
    Put the provided OpenVPN config file (.ovpn) on your Android device.
    Launch OpenVPN for Android app.
    Tap Import Profile item on the sidebar
    Navigate to the location of the .ovpn config file.
    Input the preferred name for the new profile and create it.
    Go to OpenVPN app Setting and allow FULL compression (section "Allow Compression" -> "Full").
    Tap the created profile to connect to VPN.

You can use this client for Windows, MacOS, Linux, Android and iOS.
    Download the official  OpenVPN Connect client .
    Check related instruction for  Windows ,  MacOS,   Linux , Android and iOS.

Troubleshooting

Cannot resolve DNS on Ubuntu

Cause
The DNS server is not configured on the Client VPN endpoint, or it is not being honored by the client software.
Solution
To resolve private DNS names on Ubuntu, you need to install openvpn-systemd-resolved.
The  openvpn-systemd-resolved  is a helper script to integrate OpenVPN with the systemd-resolved service via DBus.

    Install and configure update-systemd-resolved script:
sudo apt install openvpn-sysudo wget https://raw.githubusercontent.com/jonathanio/update-systemd-resolved/master/update-systemd-resolved -P /etc/openvpn/
sudo chmod +x /etc/openvpn/update-systemd-resolved
    Open the Client VPN configuration file (the .ovpn file) in a text editor and add (or uncomment) the following lines and save the file:
script-security 2
up /etc/openvpn/update-systemd-resolved
down /etc/openvpn/update-systemd-resolved
down-pre
dhcp-option DOMAIN-ROUTE .


Loses the internet when disconnected from VPN

Cause
When you disconnect from VPN, your DNS settings may fail to reset, resulting in a lost internet connection.
Solution
Reconnect to the internet:
  • Turn your Wi-Fi off and back on again.
  • Unplug your Ethernet cable and plug it back in (if you are connected to the internet via cable).