v1.6.0

This release does not contain post-install scripts for apt. Follow the instructions below to ensure the application is set up and running correctly

Download and install the deb file with:

wget https://github.com/pearsonc/pvs/releases/download/v1.6.0/pvs_1.6.0_amd64.deb
sudo apt-get install -f /path/to/download/pvs_1.6.0_amd64.deb

Add ExpressVPN or Proton VPN credentials to the openvpn-credentials.txt file and set file permissions

Replace vpnusername and vpnpassword with your ExpressVPN or Proton VPN login credentials. Note this is the VPN login, not your ExpressVPN or Proton VPN web login.

sudo mkdir -p /config
sudo echo "vpnusername" | sudo tee /config/openvpn-credentials.txt
sudo echo "vpnpassword" | sudo tee -a /config/openvpn-credentials.txt
for i in {1..2}; do history -d $(($HISTCMD-1)); done
sudo chmod 600 /config/openvpn-credentials.txt

Update config with local LAN interface and subnet to prevent being locked out

Also, in here, you can set up preferred vpn configs to use; otherwise, the app will pick at random.

sudo vi /usr/bin/pvs/config.yml

Add the service to systemd and start it

sudo systemctl daemon-reload
sudo systemctl enable pvs.service
sudo systemctl start pvs.service

A log file can be found at

tail -f /var/log/pvs.log

Update configuration file

You should ensure the configuration file contains the correct information for your network. PVS is designed to work on a gateway server with two network interfaces, but it will also work just fine on a single interface setup; however, this would need to be configured by disabling the firewall controls.

Note: PVS uses IPtables to prevent network traffic from a local interface from accessing the internet when the VPN connection rotates, is stopped, or fails. This can be turned off in the application config by disabling the firewall.

Note: If you have one network interface only, you must disable the firewall in the PVS's config to prevent locking yourself out of the server.

Note: the preferred configuration files listed by default are for European locations, excluding the UK. You can find the VPN configuration files in the same directory as the PVS config.yml file if you wish to change this list.

PVS Configuration file:

vi /usr/bin/pvs/config.yml

VPN configuration files

ls -la /usr/bin/pvs/expressvpn/vpn_configs
ls -la /usr/bin/pvs/protonvpn/vpn_configs

v1.5.0-3

This release does not contain post-install scripts for apt, follow the below instructions to ensure the application is setup and running correctly

Download and install the deb file with:

wget https://github.com/pearsonc/pvs/releases/download/v1.5.0-3/pvs_1.5.0-3_amd64.deb
sudo apt-get install -f /path/to/download/pvs_1.5.0-3_amd64.deb

Add ExpressVPN credentials to the openvpn-credentials.txt file and set file permissions

Replace vpnusername and vpnpassword with your ExpressVpn login credentials, note this is the VPN login, not your ExpressVpn web login.

sudo echo "vpnusername" | sudo tee /config/openvpn-credentials.txt
sudo echo "vpnpassword" | sudo tee -a /config/openvpn-credentials.txt
for i in {1..2}; do history -d $(($HISTCMD-1)); done
sudo chmod 600 /config/openvpn-credentials.txt

Update config with local LAN interface and subnet to prevent being locked out

Also, edit which servers to use

sudo vi /usr/bin/pvs/config.yml

Add the service to systemd and start it

sudo systemctl daemon-reload
sudo systemctl enable pvs.service
sudo systemctl start pvs.service

A log file can be found at

tail -f /var/log/pvs.log

Update configuration file

You should ensure the configuration file contains the correct information for your network, PVS is designed to work on a gateway server with two network interfaces but it will also work just fine on a single interface setup however this would need configuring.

Note: PVS uses IPtables to prevent network traffic from a local interface from accessing the internet when the VPN connection rotates, is stopped, or fails. This can be turned off in the application config by disabling the firewall.

Note: If you have one network interface only you must disable the firewall in the PVS's config to prevent locking yourself out of the server.

Note: preferred configuration files listed by default are European locations excluding the UK, you can find the VPN configuration files in the same directory as the PVS config.yml file if you wish to change this list.

PVS Configuration file:

vi /usr/bin/pvs/config.yml

VPN configuration files

ls -la /usr/bin/pvs/vpn_configs

Full Changelog: v1.5.0-2...v1.5.0-3

pvs_1.5.0-2

This release does not contain post-install scripts for apt, follow the below instructions to ensure the application is setup and running correctly

Download and install the deb file with:

wget https://github.com/pearsonc/pvs/releases/download/v1.5.0-2/pvs_1.5.0-2_amd64.deb
sudo apt-get install -f /path/to/download/pvs_1.5.0-2_amd64.deb

Add ExpressVPN credentials to the openvpn-credentials.txt file and set file permissions

Replace vpnusername and vpnpassword with your ExpressVpn login credentials, note this is the VPN login, not your ExpressVpn web login.

sudo echo "vpnusername" | sudo tee /config/openvpn-credentials.txt
sudo echo "vpnpassword" | sudo tee -a /config/openvpn-credentials.txt
for i in {1..2}; do history -d $(($HISTCMD-1)); done
sudo chmod 600 /config/openvpn-credentials.txt

Add the service to systemd and start it

sudo systemctl daemon-reload
sudo systemctl enable pvs.service
sudo systemctl start pvs.service

A log file can be found at

tail -f /var/log/pvs.log

Update configuration file

You should ensure the configuration file contains the correct information for your network, PVS is designed to work on a gateway server with two network interfaces but it will also work just fine on a single interface setup however this would need configuring.

Note: PVS uses IPtables to prevent network traffic from a local interface from accessing the internet when the VPN connection rotates, is stopped, or fails. This can be turned off in the application config by disabling the firewall.

Note: If you have one network interface only you must disable the firewall in the PVS's config to prevent locking yourself out of the server.

Note: preferred configuration files listed by default are European locations excluding the UK, you can find the VPN configuration files in the same directory as the PVS config.yml file if you wish to change this list.

PVS Configuration file:

vi /usr/bin/pvs/config.yml

VPN configuration files

ls -la /usr/bin/pvs/vpn_configs

Full Changelog: v1.5.0-1...v1.5.0-2

pvs_1.5.0-1

This release does not contain post-install scripts for apt, follow the below instructions to ensure the application is setup and running correctly

Download and install the deb file with:

wget https://github.com/pearsonc/pvs/releases/download/v1.5.0-1/pvs_1.5.0-1_amd64.deb -o /tmp/pvs_1.5.0-1_amd64.deb
sudo apt-get install -f /tmp/pvs_1.5.0-1_amd64.deb

Add ExpressVPN credentials to the openvpn-credentials.txt file and set file permissions

Replace vpnusername and vpnpassword with your ExpressVpn login credentials, not this is the VPN login, not your ExpressVpn web login.

sudo echo "vpnusername" | sudo tee /config/openvpn-credentials.txt
sudo echo "vpnpassword" | sudo tee -a /config/openvpn-credentials.txt
for i in {1..2}; do history -d $(($HISTCMD-1)); done
sudo chmod 600 /config/openvpn-credentials.txt

Add the service to systemd and start it

sudo systemctl daemon-reload
sudo systemctl enable pvs.service
sudo systemctl start pvs.service

A log file can be found at

tail -f /var/log/pvs.log

Update configuration file

You should ensure the configuration file contains the correct information for your network, PVS is designed to work on a gateway server with two network interfaces but it will also work just fine on a single interface setup however this would need configuring.

Note: PVS uses IPtables to prevent network traffic from a local interface from accessing the internet when the VPN connection rotates, is stopped or fails. This can be turned off in the application config by disabling the firewall.
Regardless if the firewall option is turned on or off if you have one network card no blocking will occur and you should disable PVS's firewall option.

Note: preferred configuration files listed by default are European locations excluding the UK, you can find the VPN configuration files in the same directory as the PVS config.yml file if you wish to change this list.

PVS Configuration file:

vi /usr/bin/pvs/config.yml

VPN configuration files

ls -la /usr/bin/pvs/vpn_configs

pvs_1.4.0-1

This release does not contain post-install scripts for apt, follow the below instructions to ensure the application is setup and running correctly

Download and install the deb file with:

wget https://github.com/pearsonc/pvs/releases/download/v1.4.0-1/pvs_1.4.0-1_amd64.deb -o /tmp/pvs_1.4.0-1_amd64.deb
sudo apt-get install -f /tmp/pvs_1.4.0-1_amd64.deb

Add ExpressVPN credentials to the openvpn-credentials.txt file and set file permissions

Replace vpnusername and vpnpassword with your ExpressVpn login credentials, not this is the VPN login, not your ExpressVpn web login.

sudo echo "vpnusername" | sudo tee /config/openvpn-credentials.txt
sudo echo "vpnpassword" | sudo tee -a /config/openvpn-credentials.txt
for i in {1..2}; do history -d $(($HISTCMD-1)); done
sudo chmod 600 /config/openvpn-credentials.txt

Add the service to systemd and start it

sudo systemctl daemon-reload
sudo systemctl enable pvs.service
sudo systemctl start pvs.service

A log file can be found at

tail -f /var/log/pvs.log

Update configuration file

You should ensure the configuration file contains the correct information for your network, PVS is designed to work on a gateway server with two network interfaces but it will also work just fine on a single interface setup however this would need configuring.

Note: PVS uses IPtables to prevent network traffic from a local interface from accessing the internet when the VPN connection rotates, is stopped or fails. This can be turned off in the application config by disabling the firewall.
Regardless if the firewall option is turned on or off if you have one network card no blocking will occur and you should disable PVS's firewall option.

Note: preferred configuration files listed by default are European locations excluding the UK, you can find the VPN configuration files in the same directory as the PVS config.yml file if you wish to change this list.

PVS Configuration file:

vi /usr/bin/pvs/config.yml

VPN configuration files

ls -la /usr/bin/pvs/vpn_configs

pvs_1.2.0-1

This release does not contain post-install scripts for apt, follow the below instructions to ensure the application is setup and running correctly

Download and install the deb file with:

wget https://github.com/pearsonc/pvs/releases/download/v1.2.0-1/pvs_1.2.0-1_amd64.deb -o /tmp/pvs_1.2.0-1_amd64.deb
sudo apt-get install -f /tmp/pvs_1.2.0-1_amd64.deb

Add ExpressVPN credentials to the openvpn-credentials.txt file and set file permissions

Replace vpnusername and vpnpassword with your ExpressVpn login credentials, not this is the VPN login, not your ExpressVpn web login.

sudo echo "vpnusername" | sudo tee /config/openvpn-credentials.txt
sudo echo "vpnpassword" | sudo tee -a /config/openvpn-credentials.txt
for i in {1..2}; do history -d $(($HISTCMD-1)); done
sudo chmod 600 /config/openvpn-credentials.txt

Add the service to systemd and start it

sudo systemctl daemon-reload
sudo systemctl enable pvs.service
sudo systemctl start pvs.service

A log file can be found at

tail -f /var/log/pvs.log

Update configuration file

You should ensure the configuration file contains the correct information for your network, PVS is designed to work on a gateway server with two network interfaces but it will also work just fine on a single interface setup however this would need configuring.

Note: PVS uses IPtables to prevent network traffic from a local interface from accessing the internet when the VPN connection rotates, is stopped or fails. This can be turned off in the application config by disabling the firewall.
Regardless if the firewall option is turned on or off if you have one network card no blocking will occur and you should disable PVS's firewall option.

Note: preferred configuration files listed by default are european locations excluding the UK, you can find the vpn configuration files in the same directory as the pvs config.yml file if you wish to change this list.

PVS Configuration file:

vi /usr/bin/pvs/config.yml

VPN configuration files

ls -la /usr/bin/pvs/vpn_configs

pvs_1.1.0-1

This release does not contain post-install scripts for apt, follow the below instructions to ensure the application is setup and running correctly

download and install the deb file with:

wget https://github.com/pearsonc/pvs/releases/download/v1.1.0-1/pvs_1.1.0-1_amd64.deb -o /tmp/pvs_1.1.0-1_amd64.deb
sudo apt-get install -f /tmp/pvs_1.1.0-1_amd64.deb

Add ExpressVPN credentials to the openvpn-credentials.txt file and set file permissions

Replace vpnusername and vpnpassword with your ExpressVpn login credentials, not this is the VPN login, not your ExpressVpn web login.

sudo echo "vpnusername" | sudo tee /config/openvpn-credentials.txt
sudo echo "vpnpassword" | sudo tee -a /config/openvpn-credentials.txt
for i in {1..2}; do history -d $(($HISTCMD-1)); done
sudo chmod 600 /config/openvpn-credentials.txt

Add the service to systemd and start it

sudo systemctl daemon-reload
sudo systemctl enable pvs.service
sudo systemctl start pvs.service

A log file can be found at

tail -f /var/log/pvs.log

pvs_1.0.8-1

Ensure to set the correct file permissions on your openvpn-credentials.txt file

sudo chmod 600 /config/openvpn-credentials.txt

All so ensure to populate the openvpn-credentials.txt file with your username and password, seperated by line.
e.g.

username
password

pvs_1.0.7-1

v1.0.7-1

Added config re-init call when connection failure occurs and retry is…

pvs_1.0.6-1

v1.0.6-1

Replaced process kill with Signal(syscall.SIGTERM) to ensure OpenVPN …