ivpn
Connect to the IVPN service
TLDR
Print the current state of IVPN, including the connection and firewall status
List available servers to connect to
SYNOPSIS
ivpn <command> [options] [arguments]
Examples:
ivpn connect
ivpn disconnect
ivpn status
ivpn servers -c US
ivpn settings set killswitch true
PARAMETERS
connect [server_id/country/city]
Establishes a VPN connection. Can connect to the fastest available server or a specific one by ID, country code (e.g., US), or city (e.g., New York).
disconnect
Terminates the active VPN connection.
status
Displays the current VPN connection status, including server details, public IP address, connection time, and protocol in use.
servers [options]
Lists available IVPN servers. Options can include filtering by country (-c), showing recommended servers (-r), or displaying detailed information.
settings [subcommand]
Manages application settings. Subcommands include get (to view settings), set (to modify settings like killswitch, anti-tracker, firewall, protocol), and reset.
account
Displays IVPN account information, such as subscription status, expiry date, and plan details.
log [options]
Displays client log messages. Useful for debugging connection issues or understanding client behavior. Options may include log level or number of lines.
version
Shows the installed IVPN client version.
help [command]
Provides help information for the main ivpn command or a specific subcommand (e.g., ivpn help connect).
DESCRIPTION
The ivpn command provides a comprehensive command-line interface for managing the IVPN Virtual Private Network service on Linux. It allows users to connect to and disconnect from IVPN servers, view connection status, list available VPN servers, configure application settings, and manage advanced features directly from the terminal. This tool is essential for headless systems or users who prefer a command-line workflow over a graphical user interface for their VPN management. It simplifies the process of interacting with the IVPN service, abstracting the complexities of underlying VPN protocols like OpenVPN or WireGuard.
CAVEATS
Requires an active IVPN subscription and a working internet connection. For certain network-level operations, such as managing the killswitch or firewall, the command may need to be run with root privileges (e.g., using sudo). The client must be properly installed and configured on the system.
INSTALLATION
The ivpn client is typically installed via official IVPN repositories or a direct download package (e.g., .deb or .rpm) provided by IVPN. It is not usually found in standard Linux distribution repositories.
DEPENDENCIES
The client relies on network utilities and potentially underlying VPN protocol implementations (like OpenVPN or WireGuard) to function correctly. Firewall management often involves interaction with system-level tools like iptables.
HISTORY
The ivpn command-line client is an official application developed by IVPN to provide robust and convenient management of their VPN service on Linux systems. It was created to cater to users who prefer a terminal-based workflow, including server administrators and power users, as well as for integration into scripts. Its development focuses on encapsulating the complexities of VPN protocols (like OpenVPN and WireGuard) into a user-friendly interface, ensuring secure and private internet access is easily configurable from the command line.