Skip to main content

vpn

vpn — ɳSelf documentation.

VPN Plugin

Multi-provider VPN management with kill switch and leak protection. Free: MIT licensed.

Install

nself plugin install vpn

What It Does

Manages VPN connections to multiple providers (NordVPN, PIA, Mullvad, and others) directly from your ɳSelf instance. Provides a kill-switch that blocks all traffic if the VPN drops. Monitors for DNS and IP leaks. Used alongside the torrent-manager plugin to enforce VPN on all downloads.

Configuration

Env Var Default Description
VPN_PORT 3200 VPN management service port
VPN_PROVIDER none Provider: nordvpn, pia, mullvad, custom
VPN_USERNAME none VPN account username
VPN_PASSWORD none VPN account password
VPN_REGION auto Preferred server region
VPN_KILL_SWITCH true Block traffic on VPN disconnect

Ports

Port Purpose
3200 VPN management REST API

Database Tables

8 tables added to your Postgres database:

  • np_vpn_connections: connection history
  • np_vpn_servers: server catalog
  • np_vpn_providers: provider configurations
  • np_vpn_profiles: VPN configuration profiles
  • np_vpn_status: current connection state
  • np_vpn_leak_tests: leak test results
  • np_vpn_rules: traffic routing rules
  • np_vpn_audit: connection audit log

Nginx Routes

None: VPN service is internal only.