Linux VPN router VM designed to share an openVPN connection with your network
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
cache * created /pia/cache to hold temporary files Aug 19, 2013
client_scripts/monitor-windows * added another error condition to monitor.vbs - redownload "Torrent … Nov 26, 2014
dev_scripts * updates in preparation for version 2 release Jul 12, 2016
documentation * and paths Jul 12, 2016
include * causing issues when storing array values. removed remaining comment… Aug 1, 2016
ovpn.d * eol Jul 12, 2016
ovpn * more paths Jul 16, 2016
.gitattributes * gitattributes, gitignore should be proper now Jul 12, 2016
.gitignore * must ignore file containinh smb password as well Aug 1, 2016
.gitmodules * gitattributes, gitignore should be proper now Jul 12, 2016
ReadMe-commands.txt * updates in preparation for version 2 release Jul 12, 2016
pia-daemon * lot more paths Apr 17, 2016
pia-prepare-ovpn * new PIA .ovpn files - adds new locations Jun 16, 2016
pia-settings * owner needs to match as well Jun 29, 2016
pia-setup * fixed documentation link Jul 28, 2016
pia-start * added ovpn.d support to pia-start Aug 3, 2016
pia-status * lot more paths Apr 17, 2016
pia-update * testing without Apr 13, 2016

Project: PIA-Tunnel VM

PIA-Tunnel VM is a series of scripts designed to share an openVPN connection with your network. It is designed to run stand alone on a virtual machine or RaspberryPi.

DO NOT run PIA-Tunnel VM on a multiuser system because it contains scripts to allow the webUI to change the root password, apply firewall rules and other things. Users with command line access could use these scripts to gain root access!


PIA-Tunnel VM supports Debian 8, Raspberry Pi (Raspbian Lite) or FreeBSD (work in progress).
It supports port forwarding, failover locations, LAN segments, offers a SOCKS5 proxy server (RasPi and FreeBSD), DHCP server and lease view (phpdhcpd) and the transmission torrent client with support for writing files onto a local NAS.

The included web interface makes it easy to setup connections and get the system configured for your network.
The included shell scripts make it possible to control the system from the command line as well.

PIA-Tunnel VM started out as a virtual machine for VMware Workstation, Player and ESXi with support for
It has since been updated to offer

  • support for more VPN proviers out of the box and offers support to add custom .ovpn files
  • also tested on KVM, XEN, Hyper-V and other virtual machine solutions
  • full support for Raspberry Pi which makes it possible to create a stand alone VPN router with a simple webUI


Author: Mirko Kaiser,
Support development with Bitcoins !thank you! 16moftUyJeyGSCHEtE8bPFE9Ubg4j3SdKG

First created in Germany on 2013-07-20
License: New BSD License

Copyright (c) 2016, Mirko Kaiser,
All rights reserved.


  • Open by design, script based with no binaries
  • Simple Web-interface and/or command line support
  • Can provide complete network isolation (leak protection)
  • SOCKS 5 proxy for LAN or VM LAN segment. compatible
  • Port forwarding to 1 IP on your LAN or private VM LAN (requires VPN provider support)
  • Supports, HideMyAss, iVPN, HideIPVPN and FrootVPN out of the box
  • Use your own Linux installation by following the steps in the "setup" subdirectory

Getting Started and Setup Instructions