A Linux CLI for ProtonVPN. Written in Python.
ProtonVPN-CLI is a full rewrite of the bash protonvpn-cli in Python, which adds more features and functionality with the purpose of improving readability, speed and reliability.
Installation & Updating
For more detailed information on installing, updating and uninstalling, please view the extensive usage guide.
- dialog (optional, needed for interactive selection)
- pip for python3 (pip3)
- setuptools for python3 (python3-setuptools)
Depending on your distribution, run the appropriate following command to install the necessary dependencies
|Ubuntu/Linux Mint/Debian and derivatives||
Installation happens via Python's package manager PIP.
Note: Make sure to run pip with sudo, so it installs globally and recognizes the command with sudo
sudo pip3 install protonvpn-cli
sudo pip3 install protonvpn-cli --upgrade
Manual Installation from source
Disclaimer: If you are unsure about what you're doing, please follow the normal installation guide.
It is recommended to do the manual installation in a virtual environment. Especially if it serves the purpose of developing.
Clone this repository
git clone https://github.com/protonvpn/protonvpn-cli-ng
Step into the directory
pip3 install -e .
For updating, you just need to pull the latest version of the repository with git.
How to use
||Initialize ProtonVPN profile.|
||Select a ProtonVPN server and connect to it.|
||Connect to a specified server.|
||Connect to a random server.|
||Connect to the fastest server.|
||Connect to the fastest P2P server.|
||Connect to the fastest server in a specified country.|
||Connect to the fastest Secure Core server.|
||Reconnect or connect to the last server used.|
||Disconnect the current session.|
||Print connection status.|
||Change CLI configuration.|
||Refresh OpenVPN configuration and server data.|
||Print example commands.|
||Show help message.|
All connect options can be used with the
-p flag to explicitly specify which transmission protocol is used for that connection (either