vpnclient_ynh/README.md

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.2~ynh4

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.

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