protonvpn
Official Proton VPN command-line client
TLDR
Sign in to Proton VPN
$ protonvpn signin [username]
Sign out$ protonvpn signout
Connect to the fastest server$ protonvpn connect
Connect to a specific country$ protonvpn connect --country [US]
Connect to a named server$ protonvpn connect [US-NY-01]
Disconnect$ protonvpn disconnect
Enable kill switch$ protonvpn config set kill-switch on
List configurable options$ protonvpn config list
SYNOPSIS
protonvpn [signin|signout|connect|disconnect|info|status]
DESCRIPTION
protonvpn is the official command-line client for Proton VPN service. It provides secure, encrypted VPN connections with features like kill switch, split tunneling, and server selection.The CLI allows scripting VPN connections and provides all functionality of the graphical client for headless servers or terminal users.
PARAMETERS
--country CODE
Restrict connect to servers in a specific country.--city CITY
Restrict connect to servers in a specific city.--protocol PROTOCOL
Override the connection protocol (e.g., wireguard, openvpn-tcp, openvpn-udp).-h, --help
Display help information.
COMMANDS
signin [username]
Authenticate with Proton VPN credentials.signout
Remove stored credentials.connect [server]
Establish a VPN connection. Without arguments, connects to the fastest available server. Accepts a server name or use --country / --city.disconnect
Terminate the active VPN connection.status
Show current connection status.info
Display account information.config list
List configurable options.config set option value
Change a configuration option (e.g., kill-switch on, netshield f1, vpn-accelerator on).
CAVEATS
Requires Proton VPN subscription. Some features require paid plans. Network manager integration varies by distribution. Root may be required for some operations.
HISTORY
protonvpn CLI was developed by Proton AG to complement their graphical VPN clients. Proton VPN emphasizes privacy and is based in Switzerland with strong privacy laws.
