Complete documentation for using and configuring your Pi VPN Hotspot. Learn about all features, SMS commands, and advanced configurations.
Pi VPN Hotspot transforms your Raspberry Pi into a portable, secure VPN gateway. All devices connecting to your hotspot automatically route through an encrypted VPN tunnel with kill switch protection.
WireGuard VPN with automatic kill switch ensures zero data leaks. If VPN drops, all traffic is blocked until connection is restored.
Automatic network scanning and connection to strongest available networks. Seamless switching between saved networks.
Full SMS control via connected Android device. Check status, restart services, or shutdown from anywhere.
Web dashboard shows live network stats, VPN status, connected devices, and system health metrics.
The system starts automatically on boot. All services (VPN, hotspot, dashboard) initialize within 30 seconds.
# Manual start if needed:
$ sudo systemctl start wg-quick@wg0
$ sudo systemctl start hostapdConnect to your hotspot using the SSID and password configured during installation. All traffic is automatically secured.
SSID: YourHotspotName
Security: WPA2-PSK
IP Range: 192.168.4.2-20