vpnclient_ynh

VPN Client for YunoHost

Lire ce readme en français.

This package allows you to install VPN Client quickly and simply on a YunoHost server. If you don't have YunoHost, please consult the guide to learn how to install it.

Overview

• Install a VPN connection on your self-hosted server.
• Useful for hosting your server behind a filtered (and/or non-neutral) internet access.
• Useful to have static IP addresses (IPv6 and IPv4).
• Useful to easily move your server anywhere.
• Strong firewalling (internet access and self-hosted services only available through the VPN, not leaking to your commercial ISP)
• Combine with the Hotspot app to broadcast VPN-protected WiFi to other laptops without any further technical configuration needed.

Shipped version: 2.0~ynh1

Screenshots

Disclaimers / important information

Please note that this application is designed to interface with dedicated, public IP VPNs accepting inbound traffic, preferably with an associated .cube (or .ovpn/.conf) configuration file. Do not expect that any VPN you randomly bought on the Internet can be used! Checkout the list of known compatible providers for more info.

Running vpnclient inside lxc

If you want to run openvpn inside lxc, you should add this to your container:

lxc.hook.autodev = sh -c "modprobe tun"
lxc.mount.entry=/dev/net/tun dev/net/tun none bind,create=file
lxc.hook.autodev = sh -c "chmod 0666 dev/net/tun"

Documentation and resources

• YunoHost documentation for this app: https://yunohost.org/app_vpnclient
• Report a bug: https://github.com/YunoHost-Apps/vpnclient_ynh/issues

Developer info

Please send your pull request to the testing branch.

To try the testing branch, please proceed like that.

sudo yunohost app install https://github.com/YunoHost-Apps/vpnclient_ynh/tree/testing --debug
or
sudo yunohost app upgrade vpnclient -u https://github.com/YunoHost-Apps/vpnclient_ynh/tree/testing --debug

More info regarding app packaging: https://yunohost.org/packaging_apps