Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
Clone this wiki locally
To install VPN Manager, either install my Kodi repository which will allow the add-on to auto update, or install the add-on directly. On some platforms you may also need to install openvpn as well.
Enabling Install from Unknown Sources
By default Kodi will not allow the installation of add-ons from unknown sources, preferring to limit the add-ons used to those from the official repos. In order to use this add-on, you have to enable "Unknown Sources" in the Settings/System/Add-ons menu. A scary warning message will appear when you enable this option. If you don't accept it, you'll not be able to install this add-on. This add-on will not gather any information on your system.
- Download and save the repository here : Repository
- Install it via Systems/Addons/Install from zip (you can put the repository zip on a network attached drive or USB key)
- Then install VPN Manager via Systems/Addons/Install from repository/Zomboided Addon repository
- Auto updates from the repository are advised. However during an update the add-on will be unavailable/unpredictable for less than a minute.
- Download and save the latest version here : Addon
- Install it via System/Addons/Install from zip file (you can put the add-on zip on a network attached drive or USB key)
- Installation should take less than a minute. A notification will be displayed when the add-on is ready to use.
LibreELEC and OpenELEC 7 and later come with openvpn already installed. For these platforms, you just need to install the add-on. For other platforms, see the appropriate section below.
In order to run on other Linux platforms, openvpn must be installed in /user/sbin and killall must also available. You'll need to work out how to fix this for your particular Linux install, but some of these commands below maybe helpful (such as for OSMC). If you're unsure, go use google:
sudo apt-get update
sudo apt-get install openvpn
sudo apt-get install psmisc
For all non LE/OE Linux platforms, sudo is also used with the openvpn and killall commands. If this is not required, there's an option in Settings/Advanced to force this off.
For Linux installs where openvpn is not installed in /usr/sbin/, you should define the path externally and use the option in Settings/Advanced to call openvpn without a path.
On all Linux platforms the openvpn log is always written to
/run to minimize writes to the physical storage. If you see an error in the log which suggests openvpn was run but the log was not found, then it could be that you have issues with permissions on the /run directory. You can fix this by changing the permissions or you can use the option in Settings/Advanced to force the openvpn log to be written to the Kodi log location.
If you have other software installed also controlling the VPN, this may cause a conflict. You should decide if you want to manage the VPN outside of the Kodi environment or not.
Download the install package from openvpn.net and install it. You must keep the option checked to update the path.
When you run Kodi, you must run it as administrator (otherwise updating the routing table will fail during VPN connection).
If you have other software installed also controlling the VPN (including packages provided by your VPN provider), this may cause a conflict. You should decide if you want to manage the VPN outside of the Kodi environment or not.