macOS

Instructions for client Viscosity:

Viscosity is an OpenVPN client for macOS which supports the tap interface also with Big Sur (macOS 11) which you need for "KIT VPN2VLAN". For the default VPN "KIT" you can use Viscosity or Tunnelblick (see below). 

If you've bought the Viscosity software yourself and you've already installed it you can download the configuration files here: Configuration files for OpenVPN. Otherwise please follow the instructions and download the software including license and configuration files from our website.

Download the software: Viscosity Installer

  1. Execute the Viscosity installer to install the software.
  2. As configuration files and license are shipped with the installer you can just start using the software. On older macOS versions (< 10.15) you have to allow the Viscosity System Extension.
  3. Click on the viscosity menu icon to establish the vpn connection (see figures 1 & 2)
Viscosity figure 1: Choose the configuration.
Viscosity figure 2: Connection is established.

 

Short instructions for client Tunnelblick:

  1. Download the OpenVPN client „Tunnelblick“ here and install it
  2. Download the configuration file for OpenVPN by right clicking on the link: kit.ovpn. Configuration for VPN2VLAN: kit-vpn2vlan.ovpn
  3. If the extension txt is added to file, remove it. The filename has to be kit.ovpn. Then double-click on the file and add it to the OpenVPN configuration.
  4. Click on the OpenVPN icon in the menu bar and click "Connect kit".
  5. Log in with your KIT account
  6. The “Tunnelblick” documentation can be found here

Detailed instructions for client Tunnelblick:

  • Download of Tunnelblick:

    Download the install file for the OpenVPN client "Tunnelblick" here. This link points to the official website of OpenVPN. You will find the download on the left below the big green arrow [Figure 1].

    Figure 1: Download of Tunnelblick
    Figure 1: Download of Tunnelblick
    Figure 2: Install wizzard
    Figure 2: Install wizard
  • Installation of Tunnelblick:

    Open the install file. If the error message ""Tunnelblick" is an application downloaded from the Internet. Are you sure you want to open it?" appears, click on "Open". The start window of the installation opens. To start the installation doubleclick on the tunnel symbol [Figure 2]. Follow the instructions. During the installation, you might be asked to insert your user name and password several times. Note that the user name and password of your computer are required here and not the login details of your KIT account. A window appears telling you the installation succeeded. Click on “Launch”. A new window will inform you there are no configuration files installed [Figure 3]. Click on "I have configuration files" and on "OK" in the next window [Figure 4].

    Figure 3: There are no VPN configurations installed
    Figure 3: There are no VPN configurations installed
    Figure 4: Add a Configuration
    Figure 4: Add a Configuration
  • VPN Configurations:

    Download the configuration file for OpenVPN (kit.ovpn) by clicking on the Link while keeping the Ctrl (Control) key pressed. If the extension txt is added to file, remove it. The filename has to be kit.ovpn. Then double-click on the file and add it to the OpenVPN configuration.

  • Adjust settings:

    Click on the tunnel icon in the menu bar, then on "VPN Details...". Click on Settings and uncheck "Disable IPv6 (tun only)". We also recommend that you select OpenVPN version 2.4 (LibreSSL).

    Figure 5: Location of Tunnelblick
    Figure 5: Location of Tunnelblick
    Figure 6: Tunnelblick settings
    Figure 6: Tunnelblick settings


    Click on "Advanced..." and check "Allow changes to manually-set network settings".
     

    Figure 7: Tunnelblick advanced settings
    Figure 7: Tunnelblick advanced settings

 

  • ​VPN connection with Tunnelblick:

             Click on the tunnel icon in the menu bar [Figure 9]. Click on “kit” and then on “Connect”. Log in with your KIT account [Figure 10]. If you want to terminate the VPN connection click on “Disconnect”.

Figure 9: Location of Tunnelblick
Figure 9: Location of Tunnelblick
Figure 10: Log in with KIT account
Figure 10: Log in with KIT account

You can edit the connection details or stop Tunnelblick by clicking on the tunnel icon.