The official Proton VPN CLI is now available

Posted on November 24th, 2020 by in Service Updates.

Illustration of ProtonVPN Linux client


July 2021: This article has been updated because the official Linux CLI tool is now a stable release. We now also offer an official Linux app with graphical user interface. Please see How to use Proton VPN on Linux for a full guide on using Proton VPN on Linux systems.

Thanks to our highly engaged user community, we have been able to offer a community-sourced Linux tool for the last two years, which has allowed Linux users to secure their internet connections with Proton VPN. You can get Proton VPN for free on Linux for your preferred distro.

Proton VPN is now pleased to announce a new, official command-line Linux tool developed by the Proton VPN team. This new CLI was produced in-house over several months, allowing us to completely rewrite the code with a focus on improved security.

If you are currently using Proton VPN for Linux Version 2.0, we recommend that you upgrade to the new official client (there are a small number of use cases where this may not be desirable, which we detail below). 

Proton VPN for Linux features

Our new Linux CLI has been rebuilt from the ground up. Its streamlined code improves stability and performance and provides a firm foundation for future developments.

It also improves security, allowing us, for example, to properly embed an always-on kill switch into the codebase. And because the CLI minimizes the need to execute code with privileged access, no sudo rights are required.

The new tool is currently available for most Debian-based systems, such as Debian itself (10+), Ubuntu (18.04+), Mint, and Kali, as well as Fedora 33+ and Archlinux / Manjaro.

It features DNS leak protection and IPv6 leak protection, and will automatically re-establish the VPN connection when you switch networks (for example when moving between office and home WiFi networks, or when you suspend and resume your laptop session).  

Once our repository has been added to your system’s software sources (see install instructions below), the CLI will be kept updated by your default package manager. 

Our new client is completely integrated with NetworkManager. It uses OpenVPN UDP by default, but OpenVPN TCP mode is available. This can be useful for defeating censorship.

The official CLI does not yet support split tunneling, and does not work on headless systems. If required, you can manually setup Proton VPN on headless systems using OpenVPN or IKEv2. We do, however, recommend upgrading to the official CLI where possible.

How to install on Debian-based systems

See How to use the official Linux CLI for full instruction on how to install the Linux CLI on all supported distros.

1. Get the Proton VPN repo setup DEB package

Download the Proton VPN DEB package

2. Install the Proton VPN repository
Open the terminal and run the following:

sudo apt-get install {/path/to/}protonvpn-stable-release_1.0.0-1_all.deb

3. Update the apt-get package list
Enter the command:

sudo apt-get update

4. Install the Proton VPN Linux CLI
Last step! Type this command:

sudo apt-get install protonvpn-cli

How to use the official Linux CLI

To start using the client, you must log using your regular Proton/Proton VPN account details in with the command:

 protonvpn-cli login [Proton VPN username] 

Please note that these are not the OpenVPN/IKEv2 login credentials used by the old community Linux client.

Then simply run:

protonvpn-cli c 
GIP of Proton VPN Linux connect

To disconnect, enter:

protonvpn-cli d

The standard kill switch can be enabled with the following command:

protonvpn-cli ks --on

Or the permanent kill switch using:

protonvpn-cli ks --permanent

Detailed instructions on how to use our official Linux CLI client are available here, or to see the full list of commands available, enter:

protonvpn-cli -h

We salute the Proton community

Our official new Linux client replaces the community Linux client that we first launched in 2018, but all of our products will always be powered by our community. Because we do not make money from ads, all product development for everything from Proton VPN for Linux to Proton Calendar and Proton Drive are possible because of user support. 

You have also helped us develop and improve our products through participation in our early access programs, where feedback, bug reports and product suggestions help us build privacy services that are most useful to you.

If you have feedback on the new Linux CLI, bug reports and suggestions can be emailed to our development team at

We want to thank all the members of the Proton community. As champions for Proton, you help us to create an internet that values security, privacy, and freedom. 

Starting with ProPrivacy and now Proton, Douglas has worked for many years as a technology writer. During this time, he has established himself as a thought leader specializing in online privacy. He has been quoted by the BBC News, national newspapers such as The Independent, The Telegraph, and The Daily Mail, and by international technology publications such as Ars Technica, CNET, and LinuxInsider. Douglas was invited by the EFF to help host a livestream session in support of net neutrality. At Proton, Douglas continues to explore his passion for privacy and all things VPN.


  1. User

    @ Douglas Crawford
    “We are working on our own official GUI Linux client, …”
    Is there already a alpha or beta of GUI version available, p.e on github ?

  2. King

    Please offer an appimage.
    Thanks for work.

  3. Bob

    I would love to see an official NixOS package for this. Currently there’s only the older community client in the NixOS repo.

  4. Proton-Groupie-L

    Working like a charm on Debian Buster. A few things I’d currently like to bring to the attention of the team at Proton that is working on this project:
    1.) The command “apt-key add” is depreciated. I suspect changing the install documentation to reflect this would save your support team, as well as many of your customers, a lot of time and headaches.
    2.) I have 2FA enabled on my account, however when connecting I was only prompted for my login and password, no 2FA code. I would appreciate seeing this additional security measure implemented here as well.
    3.) I have searched the protonvpn website for the fingerprint of the key needed to install the app, but to no avail. It may very well be that you have it posted somewhere on the site, but it does not seem to be in a very obvious place if so. The email associated with said key, “” seems pretty sketchy at a glance, especially because to the best of my knowledge, “” is not a valid ProtonMail email suffix ( i.e,, It would be great to be able to easily verify the validity of this key by a glance at an easily identifiable area on your website.

    As always, it is with sincere gratitude and hopes to improve your already amazing work that I bring these things to your attention. Proton genuinely makes the world a better place. Thank you for what you do.

  5. Lars Poehler does not exist according to the protonmail web client. Where do I send bug reports?

  6. John Galt

    Where can I find the GUI for the new linux app? I remember finding it somewhere a few weeks back, but refreshed the machine and now I can’t find it anymore. Thanks!

  7. Andrew S

    Please update the tutorial to show the (tested) procedure for installation with minimal additional KDE or Gnome packages, on Debian or Ubuntu (you choose which/which). I don’t use KDE or Gnome desktops, but I don’t mind installing a few additional packages if that is really necessary. A better solution would not depend on either of these bloated desktops. Has anyone connected successfully with ProtonVPN under Linux I wonder? I tried installing kwalletmanager (there is no “KWallet”), but the outcome is the same. I’m using Debian 5.9, and I did also write to Support Team yesterday, but a solution here that anyone could read would be great. In case my reply doesn’t appear at the comment I clicked Reply on, I am responding to Duke Silver’s Jan. 31, 2021 comment (and your reply to that). This is the litmus test for me, whether or not to upgrade to a paid plan…

  8. Sarah

    I tried using the official Linux client on a Ubuntu 20 system that is up to date, and each time it tried to connect to a server, I get an error like this:

    Adding ProtonVPN connection…
    Unknown error: can only concatenate str (not “NoneType”) to str

    I have been using ProtonVPN in this machine for several months now without troble. This just started happening very recently!

  9. mark

    After running on Ubuntu 20.04:
    proton-cli connect
    A window pop up with a password field and tells “Authentication Required – a password is required”.
    I tried the sudo password, I tried the proton account password, but nothing works. What kind of password is this?

  10. Igor

    My Ubuntu is 20.04/
    When I try start from crontab:
    */2 * * * * /home/iq7/ >> /home/iq7/proton.log
    /bin/protonvpn-cli c -f
    in logfile /home/iq7/proton.log:
    Unknown keyring error occured: Unable to autolaunch a dbus-daemon without a $DISPLAY for X11.

  11. cool dude

    I live in a country where the protonvpn domain is blocked so I can’t install the official cli via the third-party fedora repo. Are there any plans of adding this cli to the official fedora repos?

  12. Bobby

    ProtonVPN and Protonmail just keep getting better and better. Fantastic contributions to the world. Can’t praise you guys enough.

  13. jamb

    Didn’t found any source code repo
    Is this intentional to be closed source?

  14. anomili

    dev,please contact me @
    “research &”
    aslo;#apt-add-key/#apt-add-repo has been depreciated for a while just add repo key to gpg public server ,or I could make a fork specifically for “rolling and security” dists if you like as of now my dist wont allow the repo or key

  15. JJAskiz

    The ProtonVPN Program/ Software works great on the Linux Distros/ OS, Thank you so much ProtonVPN Team, Keep up the great work.

  16. fredyboubou

    Bonjour, je travail sur Qubes OS et je suis débutant. Je souhaiterais installer ProtonVPN sur une VM dédié ProtonVPN autre que ma SYS-NET. J’ai fedora 30 et debian 10. Après avoir suivi les instructions du site ProtonVPN, la ligne de commande: ne marche pas. Pouvez vous m’aider. Cordialement fredyboubou

  17. Vasya

    want gui on linux

  18. Magolor

    Wen will there be support for Arch based distros?

  19. coop

    Tried the new protonvpn-cli.
    Looks pretty much like the original. Too cumbersome to navigate to the bottom of the list to display my country, then scrolling down to my favorites. Will still use “sudo protonvpn c -f” Easier to up arrow in the terminal and enter the password.
    Expanding the search letters to two vs. one would help and a list of my last “favs” would be nice though. I appreciate your effort.

  20. spinkey

    hi proton team, how can i update my linux protonvpn cli app? thanks

  21. Fallen

    installed on pop-os however ran into the a filenotfounderror whenever i try to login command. I’ve contacted support. However, I was wondering if anyone else has had this issue and if they have a fix.

  22. theGreatCornholio!

    Just tried out the app. The improvements are noticeable! Great job and keep up the good work!

  23. Quatgür Dosinjtür

    This so-called “new” cli for Linux users is little more than breadcrumbs. Linux users are being short changed if they deign to use your service. You put only a token effort to service Linux users and as such you don’t deserve the business. We do not live on the command line like you think we do and since you could offer the same nonsense interface, reminiscent of Windows 95 to Windows as well as Mac users, but don’t, then it’s clear. You don’t take Linux seriously and that will reflect prominently in my online review coming up in two weeks.

  24. Paradigm

    Totally locked out of my network after following manual CLI (highly recommended) instructions). i thought to find an application to use with or similar to Network Manager that would allow me access to change configurations.
    My only way was through CLI and I get messages I am locked. i cannot use the auto generated password because it is too long. using a smartphone my only other device I see no option to change VPN credentials to something manageable. i also need generate my SSL key but can’t get to the internet. it may even be the VPN kill switch
    total disaster. close to 36 hours and cannot figure out how to fix.
    the troubleshooting instructions haven’t proven useful

  25. Ellen

    Thanks for the prompt replies :-\. I reinstalled Debian, this time as network install and with Gnome and SSH server (not that I think I’ll need it but just trying to be complete in info.), hoping that maybe there was something in a more inclusive install that might work better. Then reinstalled this. It worked better this time it looks like; didn’t get that error I had before, anyhow.

  26. A.W.

    Does anyone know how I can give access to protonvpn for a non administrator user profile on the same computer? Currently I created a profile but since it is non admin. account it won’t allow the user to access network settings without admin. password. ProtonVPN is under the network settings so the non admin. user will not be able to turn vpn on which is what I want them to be able to do.

  27. Ellen

    After following the installation instructions (“sudo add-apt-repository ‘deb unstable main'” failed and I had to add it manually to sources.list), when I tried to connect using “protonvpn-cli c”, I got the error “Unable to load session. Could not access keyring.” Is there a missing step, or did something fail? (This is to set up on Debian 10. I have a first-level paid account; don’t remember what your term for it is.)

  28. Sardine

    Yesterday, 26Feb2021, my Ubuntu 20.04 did some software update that required a system reboot. Protonvpn was active prior to reboot.
    When the system rebooted my internet was lost. It took me a day to hunt for the problem, being not very knowledgeable on Linux.
    Turned out the reason being the default gateway was no longer my local gateway but some ip address somewhere in the US.
    Is there something I can do to stop this error in the future as I won’t be able to disconnect protonvpn before every reboot.

  29. Me

    After today’s protonvpn beta update, I cannot connect to the service.

  30. Ellen

    I’m preparing to set up an (outgoing) Linux VPN gateway server for my LAN, so as to have VPN and DNS thru ProtonVPN for all connected devices (and I subscribe to ProtonVPN Plus). I’m trying to decide whether to use the beta or community edition. The new linux beta has a lot of features that are important to me, but I don’t understand the limitation that it won’t work on a headless server. Is there any workaround, or alternatively, when do you expect this to be possible, and to be able to use split tunneling (in case some app won’t work with VPN)? (I don’t see any mention in the comments here that implies any use of this other than for a personal workstation/laptop.)

  31. Roland

    Is there already a PPC (Big Endian) version of Proton VPN? if not, when will it be available?
    What countries can ProtonVPN spoof, and how well/fast does it work with videostreams?

  32. Douglas Crawford

    Hi Roland. I’m sorry, but we don’t support PowerPC due to the small size of its userbase. If Big Endian supports OpenVPN or IKEv2 connections then you can quite easily manually configure your strengths for ProtonVPN using the settings we have provided for other platforms in our support guides. Please see here for a list of our server locations, and here for a list of streaming services we support fopr Plus and Visionary customers.

  33. David


    I installed it on Linux Mint 20. I start it automatically when the session is opening. Is there a way to avoid to enter the root password ?


  34. SkippyTheMgnfcnt

    You can set it up as a cron job

  35. Terry

    Thanks for your efforts to make this cli available.
    Since the last update on Kali, I am getting this error:
    Error: Expecting property name enclosed in double quotes: line 1 column 176919 (char 176918)
    Any ideas?

  36. Rbow

    trying to install on Linux Mint 18 Cinnamon 64-bit
    version 3.0.6
    kernel 4.4.0-21-generic
    Some packages could not be installed. This may mean that you have
    requested an impossible situation or if you are using the unstable
    distribution that some required packages have not yet been created
    or been moved out of Incoming.
    The following information may help to resolve the situation:

    The following packages have unmet dependencies:
    protonvpn : Depends: protonvpn-cli but it is not going to be installed
    E: Unable to correct problems, you have held broken packages.

  37. Douglas Crawford

    Hi Rbow. Please see our How to use the official Linux app beta support page for a full list of Linux distros we officially support.

  39. Shawn Fernandes

    Hi All,
    Just made a UI tool for Proton VPN.
    Runs protonVPN cli commands with UI interface
    Posted it to support for testing.
    Have a nice day

  40. Douglas Crawford

    Hi Shawn. We are working on our own official GUI Linux client, but hugely value user contributions from our community such as yours. Thanks! Please do share your tool on social media for other users to enjoy.

  41. matei

    I am trying to install it on Linux Mint 18.3 and I get dependencies errors.
    Would it be a good idea to install it using pip?
    Some packages could not be installed. This may mean that you have
    requested an impossible situation or if you are using the unstable
    distribution that some required packages have not yet been created
    or been moved out of Incoming.
    The following information may help to resolve the situation:

    The following packages have unmet dependencies.
    protonvpn : Depends: protonvpn-cli but it is not going to be installed
    E: Unable to correct problems, you have held broken packages.

    The following packages have unmet dependencies.
    protonvpn-cli : Depends: python3-protonvpn-nm-lib (>= 0.3.0) but it is not going to be installed
    E: Unable to correct problems, you have held broken packages.

    The following packages have unmet dependencies.
    python3-protonvpn-nm-lib : Depends: python3-distro but it is not installable
    Depends: gir1.2-nm-1.0 but it is not installable
    Depends: python3-proton-client but it is not going to be installed
    E: Unable to correct problems, you have held broken packages.

  42. Douglas Crawford

    Hi matei. Please contact our Support Team for assistance.

  43. Star

    Yep. Working great on Pop_OS. Thanks for the hard work! Will continue to support!

  44. Unclepunchy

    Works well on Pop OS. Like others said, a GUI would be great, but it’s pretty darn easy to use via terminal in the meantime.

  45. Grahame

    Installed no problem and works well on linux mint. One problem, updates will not install unless kill switch is turned off, which is a bit annoying.

  46. Archeryagent

    Why hello, When I use the command: “sudo wget -q -O – | sudo apt-key add – ”

    I get this: “Warning: apt-key is deprecated. Manage keyring files in trusted.gpg.d instead (see apt-key(8)). OK”

    And as a result when i try to run “protonvpn-cli d” is says “command “protonvpn-cli” not found and i do not know why it is not working, could someone help?

  47. Douglas Crawford

    Please contact our Support Team for assistance.

  48. Douglas Crawford

    Hi Micheal. Please contact our Support Team for assistance.

  49. Tim

    I am running Ubuntu on a new laptop, but now the official ProtonVPN app no longer connects (i had it working before). It says my password in incorrect but I am using a password manager and it works in my other computer. I tried un-installing it, reboot, and install again with the same results.
    I tried the community app using my OpenVPN credentials and was able to connect without problems. Thought you should know.
    I am running Ubuntu 20 LTS on a Lenovo laptop, using a wired connection.

  50. Douglas Crawford

    Hi Tim. To use the new app, simply login using your regular ProtonVPN credentials. This is different from the older community app, which required separate OpenVPN credentials.

  51. J

    Just installed in fedora 33.
    It works like a charm. Really easy, really confortable. I love the way things are happening with protonmail/protonvpn/protoncalendar

  52. Grey

    Hi! Thank you for cool service.
    For the last several weeks I can’t reach protonmail using protonvpn. I upgrade plan to Plus, switch to Secure Core and TCP – nothing changes. Change network.dns.blockDotOnion to false in Firefox. VPN is working, but I can access to protonmail only with TOR browser. It’s quite confusing, Russia.

  53. Douglas Crawford

    Hi Grey. If the VPN is working, you should be able to connect to ProtonMail without any problems. Please contact our Support Team for assistance.

  54. Sundar U

    Arch linux support had been mentioned and it has been a few months now. any updates?

  55. Douglas Crawford

    Hi Sundar. We can’t provide a release date, but can confirm that Arch support is under active development.

  56. Duke Silver

    Issue on headless Ubuntu 20.10, when trying to open only get error “Unable to load session. Could not access keyring.”

  57. Douglas Crawford

    Hi Duke. Our Linux app needs one of the following dependencies installed in order to work: KWallet or Gnome-keyring. It sound like you may not have either installed. Please contact our Support Team for assistance.

  58. jaerv

    Hello Proton-Community! Just installed the new cli in Mint, but when starting, I get this info:
    [Unknown API error occured: ProtonSessionAPIError: Unsupported auth version]
    What does it mean? Same Credentials used to log into the Proton account, there they are doing well…
    Please, give me some good advice!

  59. Douglas Crawford

    Hi jaerv. Please contact our Support Team for assistance.

  60. Andrew Hull

    Thank you so much for this version! The netshield is especially cool. I was wondering if there was a way to enable the Kill Switch but allow for connections on the LAN? I recall the earlier version had an option like that.

  61. Douglas Crawford

    Hi Andrew. LAN connections should enabled (for example I receive notifications from my phone using KDE Connect), but there do seem to be issues for many users. Our developers are working on improving LAN connectivity.

  62. Drew

    I know the app is in beta, but are you going to give an option to turn off dns-leak protection? I would like to use dnscrypt-proxy while using the VPN.

  63. Leo Escar

    Hey Proton Team!
    I’ve used this beta app and I absolutely loved it. However, recently I’ve switched my distro to Arch and I am unable to use it for the time being. Any plans to add Arch support in the near future or make the code open source? Thank you for your work.

  64. Douglas Crawford

    Hi Leo. I can’t provide a release date, but we are actively working on bringing out Linux client to Arch.

  65. HiddenOne

    What is the best way to auto-start on boot or login for a Linux system?

  66. Douglas Crawford

    Hi HiddenOne. The app does not support this feature at the present time.

  67. Varg

    When I attempt to install following the above directions I get the following error:
    “Some packages could not be installed. This may mean that you have
    requested an impossible situation or if you are using the unstable
    distribution that some required packages have not yet been created
    or been moved out of Incoming.
    The following information may help to resolve the situation:

    The following packages have unmet dependencies:
    protonvpn : Depends: protonvpn-cli but it is not going to be installed
    E: Unable to correct problems, you have held broken packages.”
    “$sudo apt update –fix-missing”
    “$sudo apt install -f”
    do not fix it.
    The community version installed just fine (at least I think it did). Please advise.

  68. Douglas Crawford

    Hi Varg. Please contact our Support Team for assistance.

  69. Anon

    First off, amazing services guys. Second, however, I am on Ubuntu 18.04.5 and am getting a “Command not found”error when I use “protonvpn-cli login usernamehere” command.

  70. Douglas Crawford

    Hi Anon. Please contact our Support Team for assistance.

  71. Jerry

    Am I the only one having a problem with ProtonVPN client? The whole instalation setting up process goes well as long as I don’t pass this point:
    The always-on kill switch must be enabled with the following command:
    protonvpn-cli ks –always-on
    It still worked fine until next restart when I was not able to connect to the internet. Technically I was connected but there was no traffic… I couldn’t load any website, couldn’t send anything… I’ve thought it was because of my last system update but … I used Timeshift and followed the process again but with same result…

  72. Douglas Crawford

    Hi Jerry. This is what the always-on kill switch does – it stays active until manually disabled (protonvpn-cli ks--off).

  73. L’abat omie

    I have a différent question, someone know how utilise the interface web of proton?

  74. Douglas Crawford

    Hi L’abat omieL’abat omie. Can you please explain? Our Mail service has a web interface, but our VPN service is accessed using our apps. To view your account information, you can login to our web portal here.

  75. D. Demetrios

    Could you please explain why the GitHub v2.2.6 lists the commit by 089af8d as “Unverified.” This doesn’t look right for ProtonVPN is to be making unverified commits to its Linux client.

  76. Douglas Crawford

    Hi D. Thanks for reporting this. In future we will be very careful to ensure all commits are properly verified. Please note that all commits on Gitlab are fully signed.

  77. Linux GUI

    I wish you guys have a gui for the vpn connection. I like command line, trust, but some days your like “if I have to key Alt+Ctrl+T one more time someone shoot me in the face… Please code faster. Negative Nancy for North Carolina, US

  78. TonHud

    Hello, Proton team. Pleased to be here, trying to get and install ProtonVPN Free. My first attempt was failed. I do not understand why. Here the result:
    ~$ sudo apt-get update && sudo apt-get install protonvpn
    Obj:1 focal InRelease
    Ign:2 focal InRelease
    Obj:3 focal-updates InRelease
    Obj:4 focal-security InRelease
    Err:5 focal Release
    404 Not Found [IP: 80]
    Obj:6 focal-backports InRelease
    Obj:7 unstable InRelease
    Leyendo lista de paquetes… Hecho
    E: El repositorio « focal Release» no tiene un fichero de Publicación.
    N: No se puede actualizar de un repositorio como este de forma segura y por tanto está deshabilitado por omisión.
    N: Vea la página de manual apt-secure(8) para los detalles sobre la creación de repositorios y la configuración de usuarios.

    Any suggestion?

  79. Douglas Crawford

    Hi TonHud. This should not be happening. Please contact our Support Team for assistance.

  80. Random

    I am not able to install this. I get this error.

    W: GPG error: testing InRelease: The following signatures couldn’t be verified because the public key is not available: NO_PUBKEY 04EE7237B7D453EC NO_PUBKEY 648ACFD622F3D138
    E: The repository ‘ testing InRelease’ is not signed.
    N: Updating from such a repository can’t be done securely, and is therefore disabled by default.
    N: See apt-secure(8) manpage for repository creation and user configuration details.

  81. Douglas Crawford

    Hi Random. Please contact our Support Team for assistance.

  82. Carlo

    Please please please rpm packages or repository…

  83. Andrew Joy

    Can we keep using the bash version ? I dont want python bloat on my system.

  84. Douglas Crawford

    Hi Andrew. You can continue to use the old community Linux client.

  85. Michael

    Question: will this work for Ubuntu Mate 20.04 operating on Raspberry PI 4 (ARM)?

  86. Douglas Crawford

    Hi Micheal. In theory, yes. But if you encounter problems then please contact our Support Team for assistance.

  87. Orel

    Hi guys,
    I installed the app and everything works well and it seems very reliable.
    I have two questions:
    – Is there a feature or a workaround to run the application at startup with an autoconnect (e.g. the fastest Swiss p2p server)?
    – Will we be able to see in “proton-cli s” the status of netshield?
    Thank you very much for all this work

  88. Douglas Crawford

    Ho Orel.

    1. I’m afraid not.
    2. Run protonvpn-cli ns -s to see the status of netshield

  89. Fred

    Hey guys, where can i see a changelog for this client?
    I have updates ready to be installed, but i would like to know what’s changed from ProtonVPN CLI v3.1.0 to 3.2.0-4

  90. Douglas Crawford

    Hi Fred. In Ubuntu you will need to download the .deb file for our client from the repository, ans then run apt-get changelog ( Similar with Fedora,except run rpm -q –changelog php.

  91. nuclear_kilo

    hello all, I get a confusing error when I try to log in to the vpn via the terminal
    Error code
    AttributeError: module ‘keyring.backends’ has no attribute ‘kwallet’
    Any ideas as to how to fix this?
    Thank you

  92. Douglas Crawford

    Hi nuclear_kilo. The apps needs either KWallet or Gnome-keyring installed to work (most distros come bundled with one of these, but it looks like yours doesn’t. Please contact our Support Team for assistance.

  93. Sebastian

    Hello, where can I find the source code for this application? All I have been able to find is the source for your old, unofficial linux-cli program on your GitHub. I will not use this application if the source code is not free.

  94. Douglas Crawford

    Hi Sebastian. The app is still in beta. Its source code will be released in due time, in accordance with our regular release cycle. The older community Linux client is still available if you prefer to use it for now.

  95. Tormod Jahren

    After running command
    sudo apt-get update && sudo apt-get install protonvpn
    I try to run the command
    protonvpn-cli login [ProtonVPN ‘my username’]
    but I get the error message:
    “Didn’t find the command protonvpn-cli”
    I’ve followed the commands from the beginning on this page.

  96. Douglas Crawford

    Hi Tormod. lease contact our Support Team for assistance.

  97. DGR

    I followed everything, I thought correctly, must not have, since I couldn’t get the VPN to connect to anything. Is there a step-by-step guide to install and connect to Linux Mint?
    I use it no problem on Windows, but I’m trying to get out of Microsoft.

  98. Douglas Crawford

    Hi DGR. Please contact our Support Team for assistance.

  99. Aram

    Hi. Thank you for great work and support.
    I installed and login it successfully in virtualbox kubuntu. but when i tried to connect this line appeared
    “couldn’t reach proton API.This might happen due to connection issues or network blocks.”
    I live in Iran and there is filtering like your site, but i can connect and use protonvpn app in windows and android.
    But when i connected to protonvpn by my windows (host) and then connected protonvpn by kubuntu (guest) i could successfully connect and use it.
    What is the problem? I am very new in linux.

  100. Douglas Crawford

    Hi Aram. Please contact our Support Team for assistance.

  101. Joe

    as far as this new version is in beta does it needs to uninstall the previous version or it will supports too?

  102. Douglas Crawford

    Hi Joe. Yes, please uninstall the older community version first. See our How to use the official Linux app beta support article for full instruction.

  103. David

    does this new version different from ProtonVPN-CLI v2.2.6?
    and consider that this is in beta version is it logical to uninstall the v2.2.6 and install it instead?

  104. Douglas Crawford

    Hi David. Yes, the official version 3.x is a new client, and is completely different from the older 2.x community client. Yes, we recommend installing our new client on supported systems. And Yes, you should uninstall the community client first. See How to use the official Linux app beta support article for full instruction.

  105. Patrick

    I can’t seem to get this to work with the protonvpn-autoconnect service, like I had with the older version. Is there a way to get it to work? Thanks!

  106. Douglas Crawford

    Hi Patrick. Sorry, but the app doesn’t support this.

  107. Tony

    I would be great if you could make the app available for he popular Rasberry Pi OS.

  108. Douglas Crawford

    Hi Tony. We are working on improving the comparability of this beta app across all Linux distros.

  109. Rin Ng

    I’m using ProtonVPN CLI v3.1.0 on Ubuntu 18.04. After login, the connection command returns with the following error:
    # protonvpn-cli c
    Unknown error occured: module ‘keyring.errors’ has no attribute ‘KeyringLocked’.
    Any idea how to solve this error?

  110. Douglas Crawford

    Hi Rin. Please contact our Support Team for assistance.

  111. Commons

    Hey Proton Team – I have installed the new cli app on my ubuntu just fine, but I am having difficulty installing on my parrotOS. It is a Debian testing base with MATE enviro. Are some Debian distros not supported yet, or is it just user error?
    Thanks for all the work you do at Proton.

  112. Douglas Crawford

    Hi Commons. The app is still in beta testing phase, and we are working on ironing out compatibility issues across Linux distros. Please contact our Support Team for assistance.

  113. Dirk

    I spent some time now – I managed the command-line-approach on Ubuntu. But after discnnect the cnfiguration are lost and I can only start from command-line. The network-manager-configuration doesn’t work – it will not connect. Any ideas
    thanks Dirk

  114. Douglas Crawford

    Please contact our Support Team for assistance.

  115. Dan

    In Ubuntu 20.10, by creating ” ” and starting it automatically, you can start VPN immediately after starting Ubuntu 20.10 .

  116. Nuno Justo

    Hello, for some reason it stopped working on Linux Ubunto 20.04
    It connects ok, but if i open i have the same ip with or without vpn.
    It worked before… last month
    Thank you

  117. Douglas Crawford

    Hello Nuno. Please contact our Support Team for assistance.

  118. AguyAndhisInternet

    I’m attempting to get this variant working on a Pinephone with Mobian.

    While attempting a connection it eventually times out with the following error in NetworkManager:
    dhcp4 (ipv6leakintrf0): request timed out
    dhcp4 (ipv6leakintrf0): state changed unknown -> timeout
    Failed to request VPN secrets #3: No agents were available for this request.
    And this in the Protonvpn logs:
    — — INFO — on_vpn_state_changed:41 — State: 6 – Reason: 9

    — — ERROR — on_vpn_state_changed:74 — [!] ProtonVPN connection failed due to incorrect openvpn credentials.

    — — INFO — check_daemon_reconnector_status:98 — Checking daemon reconnector status

    Of course this variant requires sign in without openvpn credentials and I’m able to use said account on more traditional devices.

  119. Douglas Crawford

    Hi AguyAndhisInternet. There is no guarantee that our client will work with Moibian at this time, but if you contact our support team, they will try to help.

  120. Linux Mint User

    I can’t get the app to install on my Linux Mint. Here’s a copy of the terminal:

    user@UsersLM:~$ wget -q -O – | sudo apt-key add –
    [sudo] password for user:
    user@UsersLM:~$ sudo add-apt-repository ‘deb unstable main’
    user@UsersLM:~$ sudo apt-get update && sudo apt-get install protonvpn
    Ign:1 ulyana InRelease
    Hit:2 focal InRelease
    Hit:3 ulyana Release
    Hit:4 focal-updates InRelease
    Hit:5 focal-backports InRelease
    Hit:6 xenial InRelease
    Hit:7 stable InRelease
    Get:9 focal-security InRelease [109 kB]
    Hit:10 focal InRelease
    Hit:11 focal InRelease
    Hit:12 focal InRelease
    Get:13 unstable InRelease [2,521 B]
    Get:14 focal-security/main amd64 DEP-11 Metadata [24.3 kB]
    Get:15 focal-security/universe amd64 DEP-11 Metadata [56.6 kB]
    Get:16 buster InRelease [37.4 kB]
    Err:16 buster InRelease
    The following signatures couldn’t be verified because the public key is not available: NO_PUBKEY CB8D50BB77BB3C48
    Get:17 unstable/main all Packages [5,089 B]
    Reading package lists… Done
    W: GPG error: buster InRelease: The following signatures couldn’t be verified because the public key is not available: NO_PUBKEY CB8D50BB77BB3C48
    E: The repository ‘ buster InRelease’ is not signed.
    N: Updating from such a repository can’t be done securely, and is therefore disabled by default.
    N: See apt-secure(8) manpage for repository creation and user configuration details.
    user@UsersLM:~$ protonvpn-cli login
    bash: protonvpn-cli: command not found

  121. Douglas Crawford

    Hi Linux Mint User. Please contact our Support Team for assistance.

  122. ByteV

    I can’t get this to work on Kali. I get Unknown keyring error occured: Environment variable DBUS_SESSION_BUS_ADDRESS is unset
    I get this when I run the connect option. Any help is appreciated.

  123. Douglas Crawford

    Hi ByteV. Please contact our Support Team for assistance.

  124. ClearRelic

    L’installation sous Ubuntu 20.04 LTS renvoie à un code d’erreur. Python3-dialog est impossible à installer car périmer et empêche installation. Que Faire?

  125. Douglas Crawford

    Bonjour ClearRelic. Veuillez contacter notre équipe d’assistance pour obtenir de l’aide.

  126. Ricky

    ok I found it- just disregard that comment, but a little hint in the above text would still be a bit more forthcoming…

  127. Ricky

    I have to admit that I am miffed by this little gem here:
    ‘protonvpn-cli login [ProtonVPN username]
    Please note that these are not the OpenVPN/IKEv2 login credentials used by the older community Linux client.’
    Nice. aaaaaaaaaaaand … how can I get my NEW credentials if I am just upgrading and only have my OLD credentials?!?!!

  128. Douglas Crawford

    Hi Ricky. You just use your regular ProtonVPN credentials.

  129. Theophilus Holm

    Am interested and how can I join

  130. Douglas Crawford

    Hi Theophilus. You can sign up for ProtonVPN here.

  131. John Karl Braun Jr

    Simple install and quick connections. New VPN icon next to network icon. The auto kill traffic is sweet. No new traffic will flow unless VPN is connected. Awesome feature.

    Not to mention the reason to use this; Free VPN servers, Secure Core Servers(2 separate VPN IP addresses in different geographies & choose your exit server country), and of course the TOR anonymity. All VPN servers are in hardened secure locations. They do not log anything. They are Swiss based, so Net Neutrality, online freedom, electronic communication and Internet laws are at the proper level the should be globally.

    Owners built company with online privacy and security as the foundation. Staff and executives are online freedom advocates with diverse backgrounds. The founders went to the finest schools Support is great and they are always rolling out new updates and products.

    There is no VPN service as powerful as ProtonVPN. Of course, available on all platforms under one account so you have the same logins for all devices!

    If you are looking here, don’t forget about ProtonMail. Strong encryption without the hassle of setting it up like most email services. There is a ProtonMail fully encrypted free account too.

    You can’t go wrong with ProtonAG products. They have truly made complicated highly technical products simple and easy for anyone to use!

    I run an IT MSP operation on the east coast in the U.S. and have no affiliation with ProtonAG. I recommend to all my clients, associates, & friends.

  132. Richie Koch

    Thank you for the kind words John!

  133. anothermintuser

    Thank you proton team!! I use mail and VPN and it has amazing support for linux!

  134. Alessandro

    I’m running Regolith, which is based on Ubuntu but uses i3 + gnome as the desktop environment. Was able to install the protonvpn-cli, but when trying to conncet it is hanging forever at the “Connecting to ProtonVPN on SERVER#123 with UDP…” stage.
    Checking the network manager with systemctl status network-manager.service I see this error:
    vpn-connection[0x56….b36c6,”ProtonVPN US-FL#31″,0]: Failed to request VPN secrets #3: No agents were available for this request.

    I don’t expect support since it’s not Ubuntu and still in beta. But where can I find the old protonvpn client (not protonvpn-cli)? That one worked for me, probably because it’s not integrating with network-manager-gnome.

  135. Douglas Crawford

    Hi Alessandro. Full documentation for the older community Linux app is available here.

  136. Ricardo C O Freitas

    Hi there!
    I can’t use the command “apt-key” on Kubuntu 20.10! It’s deprecated!
    (so I cannot add the source into the repositories)
    Is there any other way to download protonvpn-cli?
    I have been using previous version!
    Working great, by the way!
    Tks for all your effort!


  137. Douglas Crawford

    Hi Ricardo. Please see “Add the add-apt-repository command” in the Notes section of our How to use the official Linux app beta support article (basically enter: sudo apt-get install software-properties-common)

  138. Jason

    version ProtonVPN-CLI v2.2.6 is installed on my machine, need to change it with this new one or they are the same?

  139. Douglas Crawford

    Hi Jason. The official version 3.x is a new client, and is completely different from the older 2.x community client. Yes, we recommend installing our new client on supported systems. And Yes, you should uninstall the community client first. See How to use the official Linux app beta support article for full instruction.

  140. Kapil Gidwani

    Any update for fedora and GUI app ?

  141. Andrew Vineyard

    Will this be added for arm devices like Raspberry Pi? At the moment the repo doesn’t have armhf variants, so I’m stuck using the python3 version.

  142. andy

    hi after entering this — protonvpn-cli login [ …… ]
    i am getting this … what to do
    [!] Error: The program requires root access.

  143. Douglas Crawford

    Hi andy. It looks like you have both the community and official CLI apps installed. Can you please uninstall both CLI apps (instructions here), reboot your system, and re-install the official one. If this isn’t the case (or you still have problems) please contact our support team for further assistance.

  144. features

    Is there going to be a fastest flag like the old cli tool?

  145. Douglas Crawford

    Hi features. To connect to the fastest ProtonVPN server for your location, enter: protonvpn-cli c -f

  146. zapparioso

    Which of the source repositories does contain the new linux-cli beta code? shows me the old client releases and I cannot find any beta branch. seems to be an older GUI development version (?).

  147. Douglas Crawford

    Hi zapparioso. This app is still in beta development. As soon as the app is deemed stable we’re going to fully publish all sources on GitHub.

  148. LB

    Anyone who takes online freedom and privacy seriously uses linux, should be windows thats in beta. But anyhow, good work look forward to the gui.

  149. philippe

    Merci, très bonne appli !

  150. Patrick

    Did somebody could make the VPN connection working on a fedora dist. ?

  151. Douglas Crawford

    Hi Patrick. Thew app now officially supports Fedora 33. Full instructions are available on the How to use the official Linux app beta support page.

  152. david

    works well. A GUI would really be appreciated.
    A few tips for installing the software:
    at first you have to make sure that you have the add apt repository feature installed or your will get an error. type : sudo apt-get install software-properties-common.
    Second: le command line sudo add-apt-repository ‘deb unstable main’ never worked for me and ended in some kind of python error. You still can install with the main repository manager adding the address unstable main to your list of repos. Then finish the install via terminal.

  153. Erasmo

    Bien! y para Fedora o CentOS?

  154. Douglas Crawford

    Hola Erasmo. La aplicación ahora es compatible con Fedora 33. Estamos trabajando arduamente para ampliar la compatibilidad entre las distribuciones de Linux.

  155. Hunter Odocoileus

    The one and only feature I have prayed for was an easy way to split tunnel various apps to like torrent software access the vpn while at same time I could access my LAN from thunar or nautlus, etc
    if i remeber correct i think ssh with filezilla is particulry problematic with lan shares on left side and remote shares on right side.
    i love linux mint but the tradional way of putting everything to vpn just didnt work.
    Will this function be fixed like windows 10 is so out of the box easy with ivacy.

  156. tom

    Please add an “Alternative route ” capability (just like the android version )in order to circumvent “authentication” problem . Because apparently the Iranian government has blocked the main proton server(Which is apparently is used for authentication purpose at the beginning of the connection ) and without it we can’t connect and use protonvpn on linux

  157. Andrew

    How long will it be until this is released for arm devices, like Raspberry Pi? This would really come in handy for those systems. Heck, I’m typing this up on a Raspberry Pi 4 right now. If it is available for those, I’m unable to get anything from the repo, only the following error message:
    W: Skipping acquire of configured file ‘main/binary-armhf/Packages’ as repository ‘ unstable InRelease’ does not seem to provide it (sources.list entry misspelt?)

  158. Douglas Crawford

    Hi Andrew. The client doesn’t work on Raspberry Pis (yet). We are working hard on expanding compatibility across Linux distros.

  159. eoin

    I can’t seem to get this to work on ParrotOS, I get an error that says there’s no distro template. Any way around this, since it’s a Debian based distro?

  160. Douglas Crawford

    Please contact our Support Team for assistance.

  161. fsfboy

    Works on Pinebook Pro! Thanks

  162. Isbebu Tfbae

    Very interested in the Protonmail client for Arch. Currently, I use TOR over a vpn service to access ProtonMail web iinterface. So,I look forward to seeing it in the Arch repository.

  163. zelfir

    This looks promising.
    I use two different distros one Debian based and one Red Hat based.
    As soon as you manage to distribute your client on more distros (Using Flatpak would be a good idea IMHO), I’ll take a subscription to your service ;)

  164. StevenCM

    Thank you very much for your work, I look forward to trying this new CLI client. I am pleased to read that you are working on a GUI version. Will it be developed under GTK-4? Is the source code open source?

  165. Richie Koch

    Hi Steven,
    Yes, our code is open source. You can review it here:

  166. abdolbary

    Thanks for best vpn app team.

  167. Ani

    Merci beaucoup !

  168. SeanMC

    This is awesome: I use it on my ubuntu box. The killswitch is killer. But I mainly use MX linux (debian-based) and dabble in Puppy (ubuntu-based [not really, at all, but close enough]). For whatever reason, MX won’t allow the installation outlined above. But I reckon it’d allow a .deb installation, as would Puppy. Any chance of getting a protonvpn.deb?

  169. Nedko

    Hi, is there any workaround in case a different network manager is being used e.g. Wicd?

  170. ard

    Just installed your new beta ProtonVpn for Linux, in Ubuntu 20.10 .
    I was running ProtonVpn before, but that required each time a manual start. Now the new beta integrates perfect with the O.S. and even gives an icon in the top menu bar; quit easy for controlling the VPN.
    Great, love the progress! Thanks.

  171. Paul Taylor

    These instructions need to be corrected for omissions/mistakes.
    1) The commands given need root permissions and should be prefixed by ‘sudo’
    2) After installing the application it needs to be initialized using
    sudo protonvpn-cli –init
    3) To start using the VPN requires
    sudo protonvpn-cli -c [not ‘protonvpn-cli c ‘] to connect
    sudo protonvpn-cli -d [not ‘protonvpn-cli d ‘] to disconnect

    Also, the man file is missing and needs to be supplied to follow the universal pattern for Linux CLI

  172. Matt

    Will Trisquel be supported? – I have this message while trying to install (I am not an experienced Linux user) – it all looked OK until at the end it says …

    Fetched 8,911 kB in 21s (410 kB/s)
    Reading package lists… Done
    Reading package lists… Done
    Building dependency tree
    Reading state information… Done
    Some packages could not be installed. This may mean that you have
    requested an impossible situation or if you are using the unstable
    distribution that some required packages have not yet been created
    or been moved out of Incoming.
    The following information may help to resolve the situation:

    The following packages have unmet dependencies.
    protonvpn : Depends: protonvpn-cli but it is not going to be installed
    E: Unable to correct problems, you have held broken packages.

    PS Why do I get get “Comment is a spam”?!

  173. steve crispy

    hi … I am having problems after the input protonvpn-cli login [ProtonVPN username] all I get is this … protonvpn-cli: command not found
    can you help ..

  174. James

    Great Job Proton
    keep up the good work lads
    need to remove the ProtonVPN-CLI v2.2.6 and install this new one instead?

  175. Edmund

    Also would say, that protonvpn-cli s is missing information, e.g. about acquired external IP. Some parameters were tricky to use, e.g. –list I couldn’t get work

  176. Edmund

    Why I cannot go back in CLI menus? E.g. I’ve chosen country wrongly… Would suggest to allow move back and forth in menus. Certainly similar GUI app would be expected like in MS Windows, macOS. Debian repo is a great job – thank you! Hopefully also other repos will come. Perhaps would you consider Flatpak (, Snap (, AppImage ( versions? Would cover more easily much more distros and you don’t need to create separate repos for many distros.

  177. Guglielmo Felici

    Looks stable and simple! Thank you. Two questions:
    1) Is an autostart function planned? Right now it doesn’t work with systemd, probably because of the issues with headless systems?
    2) Is the cli open source? Where can we find the code and the issue tracker?

  178. zwets

    Great news, thank you Proton!
    One suggestion: apt-key is deprecated (see apt-key(8)). You may want to use the currently recommended way to install the public key:
    wget -qO – | sudo tee /etc/apt/trusted.gpg.d/protonvpn.gpg.asc >/dev/null

  179. Sebastian

    There seems to be a formatting error in this article, the headline “How to install the official Linux beta app” comes after the actual instructions…

    Anyway, thanks for continuing to develop this. I am also looking forward to a GUI frontend for it. Is the source code for it available as it was for the previous client?

  180. Aaron Boyd

    Was kind of hoping for a richer GUI like the Windows experience, this is basically an ASCII wrapper around shell commands (which I had already scripted myself into a systemd service for connect on startup).
    Good improvement, but looking forward to a full app in the future.

  181. dsrich

    Is there any way under this version to allow access from the local area network? I am NFS-sharing disks between computers, and need to NOT break that

  182. Maxim

    I have Ubuntu 16.04. Will the new protonvpn-cli be availible for 16.04 ? Unfortunately I can’t use older versions of pvpn because of the bug ( and hope that new client will work properly.

  183. Anon

    ETA for Arch distros please(it is atleast a month now from original release)

  184. DKMOLBY

    You have a very important issue that you need to fix.
    If someone has a 2FA, they can login with out a 2FA, please fix :)

  185. writer

    Am I missing something? Your statement above, “Please use the following commands in Terminal to install the Linux beta app. If you already have the community Linux app installed, please follow these instructions to upgrade to the official app” is not followed by any commands or instructions.

  186. Baner

    An early Christmas present that is simple to open, :) , elegant to use and addresses my concerns over both DNS and IPV6. Love it, thanks to all who made this possible.

  187. Jarosław

    Works like charm, no problems with it. Thank you very much for this service and app. And IMHO GUI is not what we need in first line. Just add “protonvpn-cli c -f” to your autostart and you are ready to go!

  188. Phi

    What is the difference between the integrated VPN service in Ubuntu (I use OpenVPN) and the ProtonVPN client? Apparently, the Servers for free users are the same. The credentials are different. How does my privacy suffer/benefit from using ProtonVPN instead of Ubuntu-integrated Proton VPN services? Thank you!

  189. Anthony Russano

    my config hangs when attempting to connect…

  190. Anonymous

    When attempting to set up a VPN connection using the basic (free) option the connection requires a password that does not seem to autofill or work correctly. Reviewing the tutorial above there does not seem to be coverage on how to resolve this.
    I am extremely grateful for the services you offer and intend to purchase both email and vpn as soon as I can resolve why payment repeatedly seems to be declined to your company. Thanks for all that you do!

  191. J

    Will you please just make a gui app? I try to avoid the terminal. Thanks.

  192. Hadi

    Will there ever be a flatpak (I personally don’t care about snaps as they are proprietarily)

  193. Ben

    It is working nicely for me on Debian 10 (Buster).
    I like the simplicity of the cli.
    protonvpn c to connect, with the feedback and the
    protonvpn s showing the IP, time connected, data sent and received, kill switch enabled.
    I have been using protonvpn for a couple of years and it works better for me than anything else that I’ve tried (many). Well done proton team.

  194. Mester Imre

    Can it be repaired? (after update)
    W: Skipping acquire of configured file ‘main/source/Sources’ as repository ‘ unstable InRelease’ does not seem to provide it (sources.list entry misspelt?)

  195. Mester Imre

    The installation on Denian was as follows (sudo is used):
    Get Mirror:
    echo ‘deb [arch=amd64] unstable main
    deb-src [arch=amd64] unstable main
    ‘ |
    sudo tee /etc/apt/sources.list.d/repo.protonvpn.list
    Get Key:
    curl -fsSL | gpg –dearmor | sudo tee /etc/apt/trusted.gpg.d/repo.protonvpn.gpg
    System database update:
    sudo apt-get update
    Install ProtonVPN CLI:
    sudo apt-get install protonvpn

  196. David

    I’ve updated and testing working however it does not show in network manager until after connected, i.e., I can use network manager to disconnect ProtonVPN but not to connect.

    Is it possible (or planned) to add to network manager perhaps using the reconnect flag as default or allow us to choose what flags network manager should use (like p2p fastest) so we can setup once in cli then use network manager only from then on as a sort of gui?

  197. John

    Please open tor port for usng apt-transport-tor.

    user@debian:~$ sudo apt-get update
    Err:1 tor+ unstable InRelease
    403 Forbidden [IP: 9050]
    Reading package lists… Done
    E: Failed to fetch tor+ 403 Forbidden [IP: 9050]
    E: The repository ‘tor+ unstable InRelease’ is no longer signed.
    N: Updating from such a repository can’t be done securely, and is therefore disabled by default.
    N: See apt-secure(8) manpage for repository creation and user configuration details.

  198. Jeroen

    Why does this not work with CLI? NetworkManager works from CLI. Btw, NetworkManager supports WireGuard as well (hint!)

  199. Paul

    Way to go Proton and community. It already looks great, can’t wait to see the full release. Nice work everyone!

  200. JP

    Team Proton,
    I’ve been with you guys pretty much since day 1. Love what you are doing. Amazing how far you’ve come.
    Can I suggest an AppImage or Flatpak to allow across multiple distros. I currently use VPN via the terminal, no rush. As a final aside, I use Solus and would love to see them get Proton.
    Stay warm,
    Stay healthy,

  201. David

    Awesome work~

  202. Martin

    Thanks for the Linux app, it’s well appreciated. While OpenVPN is great, I’d prefer to use Wireguard.
    Is there a Wireguard option planned?

  203. merry

    hi, thanks for your great work! where can i find the source code on github?

  204. Gabe

    After looking for update and then following instructions, all I get now is “client is deprecated”. The command “protonvpn” doesn’t exist on my system even though I added the repo, keys, and already installed it!
    “protonvpn” 0.1.0-1 is in my pkg mgr as is the protonvpn-cli but my system does not recognize any commands with just “protonvpn”, the purported ‘new’ command. What am I doing wrong?
    When I go to the ‘notes’ section and try to uninstall the ‘protonvpn-cli’, it says it can’t it’s outside the environment, buy if I try and use the pkg mgr to uninstall ‘protonvpn-cli’ it wants to uninstall ‘protonvpn’ too. Basically trying to update has now messed everything up. Ridiculous when it’s just some simple cmd line txt files to run. Any chance the guide to update to the beta version is actually readable AND works?

  205. black

    I’ve got error after trying to execute “protonvpn-cli login [ProtonVPN username]”:
    Couldn’t reach Proton API.This might happen due to connection issues or network blocks.

  206. Andreas

    Are you planning to integrate those packages into the main Debian repos?

  207. SomeRandomGuy

    Arch Setup

    sudo pacman -S openvpn dialog python-pip python-setuptools
    git clone
    cd linux-cli
    sudo pip3 install -e .

  208. Diego

    How could you install the official app in fedora based distros?

  209. John

    Where can we view/audit the source code?
    I don’t see the “beta” version on Github…or I’m confused which version is the new beta version.

    Thank you.

  210. Jacob

    Will it work on a raspberry pi os?

  211. Douglas Crawford

    Hi Jacob. Not at present.

  212. digger

    Until there is a Fedora RPM, is it possible to convert the deb to an rpm using alien? Was going to give it a try but it doesn’t seem possible to access to download the pkg directly.

  213. Steven Howardd

    I followed the instructions above but after entering my ProtonVPN userid it would not accept a password. Using Mint Cinnamon.

  214. Anubis

    So glad to see this however doesn’t seem to play nicely with MX Linux KDE. After starting the client a notification appears that “necessary secrets for the vpn connection were not provided” and the connection just hangs, any suggestions?

  215. Gerardo

    please add archlinux support!

  216. Kristian

    Sounds good with a future GUI. For now, is there any advantage of this solution over using ProtonVPN via the innate network tools in Ubuntu?

    Thanks in advance.

  217. Kiraly Matyas

    You’re very good! I hope it will be for opensuse as well. Until then, the good old ovpn remains. Thank you for your works!

  218. BN

    Love it so far. But it does seem to run into problems if the killswitch is on after a reboot or waking from sleep. Have to go in, turn it off, then connect, and then turn it back on.

  219. Macrophag

    How does this stack up against using ProtonVPN via the Network Manager integrated in Ubuntu?

  220. Gerardo

    this cli is opensource? where the repo link?

  221. Tomi

    Shall the stable version support per application split tunneling like the Windows version? Is very annoying and insecure to split traffic based on IP, because IPs change, and besides, how do I know which IP is connecting to, let’s say, FreeTube? Using Wireshark or one of those traffic monitoring programs? That’s absurd and unfeasible for the average computer user. We need to be able telling the ProtonVPN app «Do not route Thunderbird/Twitter/whatever app already knows who we are, through PVPN servers, no matter to which server they try to connect.»

    Also, will split tunneling work if Kill Switch is enabled? I wouldn’t want to renounce to Kill Switch security nor to split tunneling isolation.


  222. SteveC

    Is it available as .deb downloadable package? We should be able to recompile this to run on, say, Arch if it were…

  223. Plasma

    This is all that I get when following your instructions:

    gpg: invalid key resource URL ‘/etc/apt/trusted.gpg.d/home:Alexx2000.gpg’
    gpg: keyblock resource ‘(null)’: General error
    gpg: key 61508B60C33A8925: 1 signature not checked due to a missing key
    gpg: key A6616109451BBBF2: 12 signatures not checked due to missing keys
    gpg: key 3B4FE6ACC0B21F32: 3 signatures not checked due to missing keys
    gpg: key D94AA3F0EFE21092: 3 signatures not checked due to missing keys
    gpg: key C8CAB6595FDFF622: 2 signatures not checked due to missing keys
    gpg: key 871920D1991BC93C: 1 signature not checked due to a missing key
    gpg: Total number processed: 9
    gpg: skipped new keys: 9
    Any assistance is greatly appreciated.

  224. David

    I would love to use the new Linux Browser but I am not a technical user so I am quite lost. Any suggestions, perhaps should I wait for the official release?

  225. Justin

    Installed on Lubuntu 20.04 . Bets CLI login works fine but upon initiating a connection Network Manager indicates VPN connection lost and CLI hangs on connecting. CLI shows successful add of connection to Network Manager but then hangs on connecting. Furthermore, DNS resolution is fouled up for workstation even when not connected to VPN. DNS problem clears up when Beta CLI is removed via package manager.

  226. Hello

    Thanks for the work, I have this problem for me if that’s usefull :
    Adding ProtonVPN connection…
    Traceback (most recent call last):
    File “/usr/bin/protonvpn-cli”, line 11, in
    load_entry_point(‘protonvpn-cli==3.0.0’, ‘console_scripts’, ‘protonvpn-cli’)()
    File “/usr/lib/python3/dist-packages/protonvpn_cli/”, line 46, in __init__
    getattr(self, args.command)()
    File “/usr/lib/python3/dist-packages/protonvpn_cli/”, line 50, in c
    File “/usr/lib/python3/dist-packages/protonvpn_cli/”, line 111, in connect
    File “/usr/lib/python3/dist-packages/protonvpn_cli/”, line 101, in connect
    domain, exit_type, entry_ip
    File “/usr/lib/python3/dist-packages/protonvpn_cli/”, line 546, in add_vpn_connection
    File “/usr/lib/python3/dist-packages/protonvpn_nm_lib/services/”, line 115, in add_connection
    File “/usr/lib/python3/dist-packages/protonvpn_nm_lib/services/”, line 49, in manage
    File “/usr/lib/python3/dist-packages/protonvpn_nm_lib/services/”, line 76, in add_leak_protection
    File “/usr/lib/python3/dist-packages/protonvpn_nm_lib/services/”, line 121, in run_subprocess
    raise exception(exception_msg)
    protonvpn_nm_lib.exceptions.EnableIPv6LeakProtectionError: Unable to add IPv6 leak protection connection/interface

  227. Sam

    When will the app/code and documentation be available to allow me to package it (create a custom package) for my Linux distro, Void Linux?
    Is the code available on github, gitlab, etc?

  228. Ip

    When RPMs for fedora?

  229. selamba

    I take it you moved the API to Not a very wise decision, since is blocked in my country, among many others, and the vpn just became inaccessible without some other vpn.

  230. Ricky

    Installed it a few days ago (Ubuntu 20.04). Seems great and reliable so far.
    Very much appreciate the Linux love, looking forward to seeing more support keep on rolling in.
    (Maybe a GUI at some point in future? I certainly don’t shy away from the terminal myself, but I always love seeing stuff on Linux becoming less “terrifying” over time for my less-tech-headed friends that are otherwise considering Linux ^_^ )

  231. Richie Koch

    Hi Ricky, you bring up a good point, and we want to make our apps as accessible as possible. We do plan on adding a GUI to our Linux app in the future, we simply don’t have a timeline yet.

  232. Prabin

    I get an error when I type
    protonvpn-cli login
    in the terminal.
    Here is the error:
    raceback (most recent call last):
    File “/usr/lib/python3/dist-packages/protonvpn_nm_lib/services/”, line 147, in get_stored_data
    UnboundLocalError: local variable ‘stored_data’ referenced before assignment

    During handling of the above exception, another exception occurred:

    Traceback (most recent call last):
    File “/usr/bin/protonvpn-cli”, line 11, in
    load_entry_point(‘protonvpn-cli==3.0.0’, ‘console_scripts’, ‘protonvpn-cli’)()
    File “/usr/lib/python3/dist-packages/pkg_resources/”, line 473, in load_entry_point
    return get_distribution(dist).load_entry_point(group, name)
    File “/usr/lib/python3/dist-packages/pkg_resources/”, line 2843, in load_entry_point
    return ep.load()
    File “/usr/lib/python3/dist-packages/pkg_resources/”, line 2447, in load
    return self.resolve()
    File “/usr/lib/python3/dist-packages/pkg_resources/”, line 2453, in resolve
    module = __import__(self.module_name, fromlist=[‘__name__’], level=0)
    File “/usr/lib/python3/dist-packages/protonvpn_cli/”, line 9, in
    from .cli_wrapper import CLIWrapper
    File “/usr/lib/python3/dist-packages/protonvpn_cli/”, line 38, in
    class CLIWrapper():
    File “/usr/lib/python3/dist-packages/protonvpn_cli/”, line 59, in CLIWrapper

  233. Tribela

    Will it be available on Arch/Manjaro distribution?
    or Source code?

  234. Black Cat

    Thank you.

  235. RICHER

    Je souhaiterais une version française de tout ce que vous expliquez en anglais et que je comprends pas. Marci

  236. richard

    hello ,

    please leave the older instructions online as those new seem readily available only for debian users.

  237. Anon

    Is there any way to run this program on Arch Linux?

  238. Douglas Crawford

    Hi Anon,

    At present, the beta app runs on Debian systems only. We will be rolling out support for other distros (including Arch) moving forward.

  239. sjvrh

    When? And why remove the old one before the new one is ready? ( )

  240. John

    Any rpm packages or repository? Or only Debian/apt?

  241. Douglas Crawford

    Hi John,

    At present, the beta app runs on Debian/apt systems only. We will be rolling out support for other distros moving forward.

  242. Hanesh

    Proton is best vpn client for windows and android. Now it’s Available for Linux. Thanks Proton VPN for your best Service.

  243. Marc

    does not work on linux mint 18.1 (I do not want to upgrade mint on this PC as it’s : “long term support release which will be supported until 2021”
    error message: protonvpn : Depends: protonvpn-cli but it is not going to be installed
    please advice. thanks, Marc

  244. Frog

    When will support come to non-debian systems (primarily arch)?

  245. DJViking

    How goes the work on the GUI desktop client?

  246. Richie Koch

    We are working on a GUI for our Linux app, but at the moment we don’t have a timeline.

  247. Dim

    Any update on ATV proton vpn client?

  248. Stephanie

    I use kali linux and get the following messages when trying to add the ProtonVPN repository:
    Warning: apt-key is deprecated. Manage keyring files in trusted.gpg.d instead (see apt-key(8)).
    sudo: add-apt-repository: command not found

  249. Elvin

    Looks really good! Can’t wait to use this on Fedora. What’s the timeline for adding supporting distros other than Ubuntu/Debian?

  250. hyw

    Just to double-check: there are 3 different CLI (2 active, 1 deprecated) right? (see below)
    1. The one described in this blog post, does not require `sudo`
    2. The one written in Python that’s maintained by ProtonVPN and requires `sudo` on many operations (
    3. (deprecated) Another one written in Python (

  251. John

    at same time of this announce ( it’s a great news ) the former page for linux cli instructions has been removed. That page contained instructions on setup the vpn on fedora which is not available for de moment to he new linux app.
    Where can I get fedora instructions ?

  252. Mark

    Awesome work! Does this instruction work for Manjaro Linux (Arch Linux) as well? Can´t wait to try it out!

  253. Mike

    Will this be available in the official Debian repository?

  254. Charles

    Woot!!! Super awesome!

    Or; it would be; maybe.

    Installation instructions for the many non-Debian linuxen in the wild?

    I mean. I have a Centos server, a FreeBSD server, and a Manjaro laptop. Not a single Debian or *buntu in the network.

  255. john galt

    thank you!

  256. David

    $ protonvpn-cli login
    Traceback (most recent call last):
    File “/usr/bin/protonvpn-cli”, line 6, in
    from pkg_resources import load_entry_point
    File “/usr/lib/python3/dist-packages/pkg_resources/”, line 3088, in
    File “/usr/lib/python3/dist-packages/pkg_resources/”, line 3072, in _call_aside
    f(*args, **kwargs)
    File “/usr/lib/python3/dist-packages/pkg_resources/”, line 3101, in _initialize_master_working_set
    working_set = WorkingSet._build_master()
    File “/usr/lib/python3/dist-packages/pkg_resources/”, line 565, in _build_master
    ws = cls()
    File “/usr/lib/python3/dist-packages/pkg_resources/”, line 558, in __init__
    File “/usr/lib/python3/dist-packages/pkg_resources/”, line 614, in add_entry
    for dist in find_distributions(entry, True):
    File “/usr/lib/python3/dist-packages/pkg_resources/”, line 1964, in find_on_path
    for dist in factory(fullpath):
    File “/usr/lib/python3/dist-packages/pkg_resources/”, line 2026, in distributions_from_metadata
    if len(os.listdir(path)) == 0:
    PermissionError: [Errno 13] Permission denied: ‘/usr/local/lib/python3.6/dist-packages/urllib3-1.26.2.dist-info’

Comments are closed.

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 It may take us longer to respond.

Email us