Note: This article covers Kodi installations with OpenELEC 6 which have support for OpenVPN removed. For other versions and LibreELEC, please consult the other article in this section.
Disclaimer: Please keep in mind that, although the technical process is as thoroughly documented as possible, you need to have at least some technical understanding. There's always a chance of an oversight, things being changed and the article not yet updated.
Important note: Please make sure that you run an IPv4 Internet connection. Some Internet Service Providers already connect with the IPv6 protocol, which is not supported by CyberGhost. While the CyberGhost client takes care of deactivating IPv6 under Windows, users of native protocols have to do this manually. If IPv6 is not deactivated, data might leak outside the IPv4 VPN tunnel!
Step 1: Configure a OpenVPN connection
Visit your CyberGhost VPN online account.
Click on the 'My Devices' entry and then on the 'Add Device' button.
In the list of supported Operating Systems, please click on 'Other' to be able to setup all of the necessary options for the OpenVPN protocol. When done, the screen will extend and a 'Create new credentials' option will appear. Click that button.
Scroll up the page. As illustrated, the placeholder for a new device is now replaced by 'Linux, Router, etc.'. Click on it:
Type in a name for your new device and activate the desired extra features, provided with each Premium subscription. These features can also be activated/deactivated at a later time.
Scroll down and generate the login and configuration data for the OpenVPN protocol, which will be implemented into the needed configuration file:
- Protocol: Choose the OpenVPN protocol you want to use:
- OpenVPN (UDP): UDP allows higher speed than the TCP version, but can result in broken downloads in some cases. This is the default setting and recommended.
- OpenVPN (TCP): TCP allows more stable connections than the UDP version, but is a bit slower. Choose this version, if you have recurrent connection issues such as sudden disconnections.
- Country: The country you choose here is of no importance because the VPN Manager for Kodi will do this job later on. For now this ensures that the configuration file will be generated properly.
- Server group: The group you choose here is also of no importance for the VPN Manager for Kodi, it is however for the proper generation of the configuration file.
After setting up the connection details please note down the following details. You will need them to configure your device:
- User name: Solely generated for protocol usage. This is NOT your regular CyberGhost account user name.
- Password: Solely generated for protocol usage. This is NOT your regular CyberGhost account password.
Once configured (as detailed above), please download the configuration file. Click on 'Download Configuration' and save the file on your computer. It's a ZIP file, which contains the following single configuration files:
- client.crt: This is the user certification file
- client.key: This is your private key file
- openvpn.ovpn: This is your OpenVPN configuration which can be deleted (the VPN Manager creates it's own)
- ca.crt: This is the certificate of the certification authority (not needed later on, can also be deleted)
Unzip the files 'client.crt' and 'client.key' from the zipped configuration file to a folder on your desktop.
Step 2: Get and install OpenVPN
Since OpenELEC 6 doesn't include openvpn you first need to download and install the 'Unofficial addon repository': For that start OpenELEC and click on 'System > Addons > Search':
Type 'Unofficial' in the search field and click on 'Done':
Open the repository entry either via double click or the context menu ...
and install it:
After the installation move back to the add‐ons root ('Myadd‐ons') and click on 'Install from repository':
Choose 'Unofficial OpenELEC Add‐ons':
Move to 'Program add‐ons' and install 'openvpn' by Stefan Saraev.
Optional: Test the OpenVPN installation
To test your installation of OpenVPN, you need a SSH connection provided by the program 'Putty'. Download its Windows installer, install the program and start it. In the first window enter the IP address of your Kodi device, press 'Open' and enter login ('root') and password ('openelec', resp. 'libreelec').
Type 'openvpn' at the prompt. You should get a bunch of options displayed.
Step 3: Get VPN Manager for OpenVPN and copy files
To make sure, the VPN Manager gets updated properly, download the complete repository, as opposed to just the single add-on and copy the unzipped file to the folder with the certificate and the key.
Now copy all files to your device. For that you need access to the file system on your OpenELEC/LibreELEC device. The easiest way is by using a FTP client like Filezilla:
- First check for the OpenELEC/LibreELEC network IP address, usually something like '192.168.178.XXX' and note it. If you don't know how to find it, have a look at 'System > System info > Summary > IP address' in your Kodi media center.
- Start Filezilla, click on 'File > Server manager' and configure a new connection to your OpenELEC/LibreELEC device:
- Enter the 'Server' address (this is the network address of your OpenELEC/LibreELEC device), e. g. '192.168.178.25'
- Choose 'SFTP' as the 'Protocol'
- Choose 'Normal' as 'Connection type'
- Enter the 'User name' of OpenELEC/LibreELEC, usually 'root'
- Enter 'Password' for OpenELEC (usually 'openelec'), resp LibreELEC (usually 'libreelec')
- Click on 'Connect'
- Filezilla opens the file system of your Kodi installation right inside the folder 'storage'. Create a new folder called 'downloads' or 'VPN' or whatever you want to call it.
- Open the newly created download folder and copy all files into it (namely the files 'client.crt' and 'client.key' and the zipped repository file).
Step 4: Install VPN Manager for OpenVPN
As before click on 'Install from zip file' and move to the folder, where you copied the three files from the last step to. Mark the repository and click on 'OK'.
After the repository got installed, click on 'Install from repository', choose the 'Zomboided Add-on Repository', click on 'Services', then on 'VPN Manager for OpenVPN' and at last on 'Install'.
Step 5: Configure VPN Manager for OpenVPN
After installation move to 'My add-ons' and open the entry 'Services':
Open 'VPN Manager for OpenVPN' and click on 'Configure'. You can use the Wizard or do it manually, like we do it here (although the steps are the same). In the tab 'VPN Configuration' choose 'CyberGhost' as the 'VPN Provider' and enter the user name and the password you noted in step 1. DO NOT use your regular CyberGhost credentials.
Click on 'OK' and select the connection profile, which fits your subscription: 'Premium and Premium Plus Account' or 'Promo Account':
The next step is about the two files you saved from the downloaded configuration file.
Click on 'OK' and then select the user certificate ('client.crt') and the user key ('client.key'). Once done, the VPN Manager will connect to your first VPN.