Private Internet Access

Private Internet Access is the world's leading consumer VPN service. At Private Internet Access we believe in unfettered access for all, and as a firm supporter of the open source ecosystem we have made the decision to open source our VPN clients. For more information about the PIA service, please visit our website privateinternetaccess.com or check out the Wiki.

PIA VPN for iOS

With the Private Internet Access VPN app for iOS, you can access our network of VPN servers across the world from your iPhone, iPad or iPod touch (64-bit only). Choose among many available countries and connect to them easily. Features include kill switch, multiple VPN protocols, DNS/IPv6 leak protection and Safari Content Blocker for ad-blocking while browsing with Safari.

Getting started

The PIA VPN app features:

Installation

Requirements

iOS 11.0+ / macOS 10.11+
Xcode 9+ (Swift 4)
Git (preinstalled with Xcode Command Line Tools)
Ruby (preinstalled with macOS)
CocoaPods 1.5.0
SwiftGen
Go

It's highly recommended to use the Git and Ruby packages provided by Homebrew.

Testing

Download the app codebase locally:

$ git clone https://github.com/pia-foss/vpn-ios.git

Assuming you have a working CocoaPods environment, setting up the app workspace only requires installing the pod dependencies:

$ pod install

After that, open PIA VPN.xcworkspace in Xcode and run the PIA VPN target.

If the build does not complete due to missing modules (often PIAAccount), run pod install again with the partial build, then build again.

For the VPN to work properly, the app requires:

App Groups and Keychain Sharing capabilities
App IDs with Packet Tunnel entitlements

both in the main app and the tunnel extension target.

Hotspot Helper API

We use a special entitlement to participate in the process of joining Wi-Fi/hotspot networks (https://developer.apple.com/documentation/networkextension/nehotspothelper)

You need to request this entitlement to Apple or remove the call to configureHotspotHelper() in AppDelegate.swift and adapt the entitlements file to your needs.

Contributing

By contributing to this project you are agreeing to the terms stated in the Contributor License Agreement (CLA) here.

For more details please see CONTRIBUTING.

Issues and Pull Requests should use these templates: ISSUE and PULL REQUEST.

Authors

Jose Blaya - ueshiba
Davide De Rosa
Amir Malik (before 2016)

License

This project is licensed under the MIT (Expat) license, which can be found here.

Acknowledgements

GradientProgressBar - Felix Mau (me(@)felix.hamburg)
TunnelKit - © 2018 - Present Davide de Rosa (https://github.com/passepartoutvpn/tunnelkit) - TunnelKit is not MIT software and remains under the terms of the GPL license (https://github.com/passepartoutvpn/tunnelkit/blob/master/LICENSE)

pia-foss/mobile-ios

pia-foss

Reviews

Repository Details