Return to protonvpn.com Facebook   Twitter   Reddit   Instagram   Mastodon   ProtonMail
Support Center / Download and setup / How to use the official Linux app beta

How to use the official Linux app beta

The official ProtonVPN Linux beta app is available for Linux Debian 10+, Ubuntu 18.04+, and most distros based on these Linux versions (including Mint and Kali, but not Ubuntu Server or Raspbian). Support for more distros will follow. If you are using ProtonVPN for Linux Version 2.0, we recommend that you upgrade to the new official client. Please note that the new ProtonVPN app doesn’t currently support Split Tunneling and doesn’t run on headless servers. If you need these features, then the community Linux app remains available.

How to install the official Linux beta app

If you are using an older version of  our Linux client, we recommend that you uninstall it before installing the new app. Please see the Notes(1) section at the end of this article for instructions. 

Open Terminal and enter the following commands (or just copy and paste them in).  Note: before starting, we recommend running the following command to ensure you system is up to date:

sudo apt-get upgrade


1. Add the ProtonVPN repository to your system’s software sources(2):

wget -q -O - https://repo.protonvpn.com/debian/public_key.asc | sudo apt-key add - 

Followed by:

 sudo add-apt-repository 'deb https://repo.protonvpn.com/debian unstable main'

Note: Once this repo has been added, the app will be kept updated by your default package manager. 2. Install the client: sudo apt-get update && sudo apt-get install protonvpn

How to use the official Linux beta app

1. Log in using your regular Proton/ProtonVPN account details (please note that these are not the OpenVPN/IKEv2 login credentials used by the older community Linux client). Log in with the command:

 protonvpn-cli login [ProtonVPN username]

You will be prompted to enter your password. If you don’t have a ProtonVPN account you can sign up for one here. The app will remember your login details between sessions. 2. Open a list of ProtonVPN servers with:

protonvpn-cli connect (or protonvpn-cli c)

3. Select a server location and click OK.Select a server at that server location and click OK. 4. Select udp or tcp (we recommend udp unless you have a reason to choose tcp). GIF for Linux login A connection to the VPN server will now be established. To check your connection status, enter:

protonvpn-cli status (or protonvpn-cli s)

To disconnect, enter:

protonvpn-cli disconnect (or protonvpn-cli d)

Alternatively, you can disconnect using NetworkManager. GIF for Linux connect

How to use the kill switch

The ProtonVPN official Linux app includes a kill switch. The basic kill switch will block all your internet connections when the VPN app is running and the connection to one of our servers fails. To enable it, enter:

protonvpn-cli ks --on

The app also features an always-on kill switch. This prevents all internet connections unless the VPN app is running and connected to one of our servers. To enable it, enter:

protonvpn-cli ks --always-on

You can disable the kill switch by entering:

protonvpn-cli ks --off

How to connect using the command-line

To see the full list of connection options, enter: 

protonvpn-cli c --help 

GIF for Linux disconnect To connect to the fastest ProtonVPN server for your location, for example, enter:

protonvpn-cli c -f

Or to connect to the fastest Tor server (Plus and Visionary users only), enter:

protonvpn-cli c --tor

Additional connection options, including specifying a custom DNS server, can be found by entering:

protonvpn-cli config --help

Please note that the official Linux app beta is under active development, so there may be changes to the commands described above. Entering protonvpn-cli h (or protonvpn-cli –help) will always show the latest commands supported by the app.

How to uninstall the official Linux CLI app

If you wish to uninstall the  ProtonVPN official Linux CLI app, open Terminal and: 1. Disable the kill switch (if it is running). To do this, enter:

protonvpn-cli ks --off

2. Uninstall the app with:

sudo apt-get autoremove protonvpn

3. Remove any leftover files:

rm -rf ~/.cache/protonvpn

And 

rm -rf ~/.config/protonvpn

Notes

1.To uninstall the older community ProtonVPN app,  run:

protonvpn configure

Select option 7) Purge Configuration. Then uninstall through the package manager you used for installation. For Debian, if the package is installed system-wide then use the command:

sudo pip3 uninstall protonvpn-cli

If not, then use:

pip3 uninstall protonvpn-cli

2. Some minimal Debian distros (for example, Knoppix) do not include the add-apt-repository command. If you are missing this command then you can install it by running:

sudo apt-get install software-properties-common

Leave a Reply

Your email address will not be published. Required fields are marked *

Don't find your answer? We're happy to help you!     Contact Our Support Team

Secure your internet

Get ProtonVPN

For customer support inquiries, please submit the following form for the fastest response:
https://protonvpn.com/support-form

For all other inquiries:
contact@protonvpn.com

You can also Tweet to us:
@ProtonVPN