evpn

Unofficial CLI wrapper for the local ExpressVPN desktop client.

evpn does not implement a VPN protocol, bundle ExpressVPN, or bypass account requirements. It calls the expressvpnctl binary that ships with the installed ExpressVPN desktop app.

Install

npm install -g evpn

Requirements

• macOS with the ExpressVPN desktop app installed.
• Node.js 18 or newer.
• A valid ExpressVPN account.

The default controller path is:

/Applications/ExpressVPN.app/Contents/MacOS/expressvpnctl

You can override it with:

evpn --ctl /path/to/expressvpnctl status

Usage

Log in with an activation code:

evpn login

Check status:

evpn status

List available regions:

evpn regions
evpn regions japan
evpn regions usa --json

Connect:

evpn connect smart
evpn connect japan-tokyo
evpn connect south-korea-2

Disconnect:

evpn disconnect

Allow CLI connections while the ExpressVPN GUI is not running:

evpn background enable

Pass through a raw expressvpnctl command:

evpn raw get protocol
evpn raw set networklock true

Publishing

Before publishing, make sure the package name is still available:

npm view evpn

Publish:

npm login
npm publish --access public

Then verify:

npm install -g evpn
evpn status

Security

evpn login writes the activation code to a temporary 0600 file because expressvpnctl login requires a file path. The file is removed immediately after the login command exits.

This package has no runtime dependencies and does not collect telemetry.

Disclaimer

This project is unofficial and is not affiliated with, endorsed by, sponsored by, or maintained by ExpressVPN. ExpressVPN is a trademark of its respective owner.