12VPX for Linux

Contents

• Setup
• Subscription URL
• Usage
• Downloads
• Desktop App - Optional
• Requirements
• Downloads
• Tips & Tricks
• DNS leaks
• Troubleshooting
• Remove VPX DNS

If you experience an issue please report your Linux distribution, CPU architecture, the VPX version you installed, a description of the problem, and steps needed to reproduce it.

Note: we aim to support a wide array of Linux distributions and flavors, but cannot guarantee that your specific setup will work.

Setup

To install VPX for Linux, please follow these steps:

• Download the package suitable for your Linux distribution and CPU architecture from the Downloads section below.
• Install the package.
• Run vpx install to complete the setup.
• Run vpx login <subscriptionUrl> using the subscription URL found below to login and retrieve the server list.

For example, on a typical Ubuntu computer:

cd Downloads
sudo dpkg -i vpx-26.4.1-x86_64.deb
vpx install
vpx login https://example.com/api/vpx-linux/GiBbEriSH

Fedora:

cd Downloads
sudo dnf install vpx-26.4.1-x86_64.rpm
vpx install
vpx login https://example.com/api/vpx-linux/GiBbEriSH

Arch Linux:

cd Downloads
sudo pacman -S vpx-26.4.1-x86_64.pkg.tar.zst
vpx install
vpx login https://example.com/api/vpx-linux/GiBbEriSH

Subscription URL

This is the subscription URL for your account:

Usage

• Open the web interface by running vpx open or navigate your browser to http://127.0.0.1:9847.
• Run vpx help for more information on using the CLI.

Downloads

Desktop App - Optional

The desktop app is optional. It acts as a remote control for the main app.

Requirements

• Download, install and setup the VPX for Linux app described above.
• Download and install the desktop app found below.

Downloads

Tips & Tricks

DNS leaks

If DNS leaks are a concern, please follow these steps to prevent it:

• Enable TUN mode
• Select a regular server (not optimized for your location)

Troubleshooting

Remove VPX DNS

If vpxd crashes, or you restart the computer without a proper shutdown, you may be stuck with the VPN DNS (10.255.0.1) in your /etc/resolv.conf file.

To have NetworkManager clean this up, please run:

sudo bash -c '
  set -e
  read NAME DEV < <(nmcli -t -f NAME,DEVICE,STATE connection show --active \
    | awk -F: "\$3==\"activated\" && \$2!=\"\" && \$2!=\"lo\" && \$2 !~ /^vpx/ { print \$1, \$2; exit }")
  echo "Cleaning DNS on $NAME ($DEV)"
  nmcli connection modify "$NAME" -ipv4.dns 10.255.0.1
  nmcli connection modify "$NAME" ipv4.ignore-auto-dns no
  nmcli device reapply "$DEV"
'