Skip to content

Installation

Install ActiveVPN on any supported platform.

Requirements

  • Python 3.8 or newer
  • pip
pip install activevpn

The activevpn console command becomes available on your PATH.

Install from source

git clone https://github.com/rkriad585/ActiveVPN.git
cd ActiveVPN
pip install -r requirements.txt

Or install it as a package in development mode:

pip install -e .

Platform notes

Linux

sudo apt update && sudo apt install -y python3 python3-pip
pip install activevpn

--kill and --kill-force require root: sudo activevpn --kill.

macOS

Install Python via Homebrew:

brew install python
pip install activevpn

Windows

  1. Install Python from python.org (tick "Add Python to PATH").
  2. Open a terminal (run as Administrator for --kill).
pip install activevpn

Android (Termux)

pkg install python
pip install activevpn

Verify the install

activevpn --help

You should see the banner and the help menu. See getting-started.md for your first scan.


← Back to Home