Support Center / Download and setup / How to install a VPN on Debian

How to install a VPN on Debian

Proton VPN running on Debian

Our app officially supports the latest stable Debian version. It should also work with most distros based on Debian (not Ubuntu Server or Raspbian), but they are not officially supported.

1. Get the Proton VPN repository setup DEB package

This package contains the repository configuration and keys that are required to install the Proton VPN app.

Download the Proton VPN DEB package

2. Install the Proton VPN repository

Double-click the downloaded DEB package to install the repository using your default package manager. 

Please don’t try  to check the GPG signature of this release package (dpkg-sig –verify). Our internal release process is split into several part and the release package is signed with a GPG key, and the repo is signed with another GPG key. So the keys don’t match.

If you want to check the repo package integrity, you can check its checksum with the following command:

echo "c68a0b8dad58ab75080eed7cb989e5634fc88fca051703139c025352a6ee19ad  protonvpn-stable-release_1.0.3-2_all.deb" | sha256sum --check -

3. Update the apt-get package list

The following command updates the list of available packages and their versions. Doing this allows you to install the Proton VPN App. Open Terminal and enter:

sudo apt-get update

4. Install the Proton VPN Linux app

Last step! Type this command:

sudo apt-get install proton-vpn-gnome-desktop

Linux system tray icon

By default, the GNOME desktop doesn’t support tray icons. To enable this functionality on Debian-based distributions, run:

sudo apt install libayatana-appindicator3-1 gir1.2-ayatanaappindicator3-0.1 gnome-shell-extension-appindicator

On Debian 11, you’ll need to restart your computer. Once you’ve done this, open the Extensions app and ensure that Ubuntu AppIndicators is toggled on before launching the app.

Learn how to use the Proton VPN Linux app

Notes

1. How to remove the official Linux app

To uninstall the Linux app, open a terminal and enter:

sudo apt autoremove "protonvpn*" proton-vpn-gnome-desktop

2. How to remove the old (v3) app

To uninstall the old (v3) Linux app:

sudo apt-get autoremove protonvpn

Remove any leftover files:

rm -rf ~/.cache/protonvpn

And

rm -rf ~/.config/protonvpn

2. Disable Kill Switch if you have uninstalled the app

The Kill Switch can be easily disabled from within the official Linux app, but this will not be possible if you uninstalled the app first without disabling the Kill Switch. This may result in your system being unable to access the internet. To remove the Kill Switch after the app has been uninstalled:

a) Identify Proton VPN connection names by running the command:

nmcli connection show --active

This will display a list of all your system’s active connections.

b) Look for any connections with the pvpn- This usually includes pvpn-killswitch and pvpn-ipv6leak-protection, and may include pvpn-routed-killswitch. Delete all these connections using the following command:

nmcli connection delete [connection name]

For example:

nmcli connection delete pvpn-killswitch

c) Re-run the following command to verify that Proton VPN connections have been deleted:

nmcli connection show --active

If any Proton VPN connections remain, delete them as described above.

3. Required dependencies

Our Linux app needs one of the following dependencies installed in order to work. Installing both of these dependencies is not recommended as it may cause problems:

  • KWallet or
  • Gnome-keyring

Note that most distros come pre-installed with one of these dependencies, so usually no additional configuration is required. Also required is:

  • systemd

4. Try out our beta Linux app

The beta version of our Linux app gives you access to new features before they are released publicly, but it is still in development. By using the beta version and sharing your feedback, you can help us find and address bugs. 

Important: You cannot upgrade from the beta version of our Linux app to the stable version. You will need to uninstall the beta app and then install the official app. Similarly, if you are using the stable version of our Linux VPN app, you should uninstall it before installing the early beta version. 

If you would like to install the beta version instead of the stable release of this app:

1. Download the beta package. Enter:

wget https://repo.protonvpn.com/debian/dists/unstable/main/binary-all/protonvpn-beta-release_1.0.3-2_all.deb

2. Install the Proton VPN beta repository containing the new app. Run:

sudo dpkg -i ./protonvpn-beta-release_1.0.3-2_all.deb && sudo apt update

3. If you’re running the old (v3) Proton VPN app or CLI (stable or beta versions), simply run:

sudo apt update && apt upgrade

If you don’t have Proton VPN installed, run:

sudo apt install proton-vpn-gnome-desktop

To check for updates and ensure that you’re running the latest version of the app, enter:

sudo apt update && apt upgrade

How to remove the beta Linux app

To uninstall the new Linux app, open a terminal and enter:

sudo apt purge "protonvpn*" proton-vpn-gnome-desktop && sudo apt autoremove

Secure
your internet

Get Proton VPN
Get Proton VPN

Contact us

Support form

Tell us about the problem and we'll get back to you as soon as we can.

Open support form

Live chat

Get help from a support agent in real time. Available with a paid VPN subscription.

Chat with us

Secure email

Send us an encrypted message at contact@protonvpn.com. It may take us longer to respond.

Email us