Firefox VPN Extension — Keep a Low Browsing Profile with PIA


Translations for all locales can be downloaded with the following task:

Saved searches

Use saved searches to filter your results more quickly

Cancel Create saved search

You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session. You switched accounts on another tab or window. Reload to refresh your session.



This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.

Switch branches/tags
Branches Tags
Could not load branches
Nothing to show
Could not load tags
Nothing to show

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Cancel Create

  • Local
  • Codespaces

Use Git or checkout with SVN using the web URL.
Work fast with our official CLI. Learn more about the CLI.

Sign In Required

Please sign in to use Codespaces.

Launching GitHub Desktop

If nothing happens, download GitHub Desktop and try again.

Launching GitHub Desktop

If nothing happens, download GitHub Desktop and try again.

Launching Xcode

If nothing happens, download Xcode and try again.

Launching Visual Studio Code

Your codespace will open once ready.

There was a problem preparing your codespace, please try again.

Latest commit

Git stats


Failed to load latest commit information.

Latest commit message
Commit time

README v0.4 / 15 January 2019

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

Chrome Web Extension

This repo contains all the code needed to build and run the Private Internet Access Chrome Web Extension. This extension allows a user to access our network of proxies across the world from their web browser. Users can choose a proxy server location and connect to it directly from the extension. Additional privacy and security features include disabling microphone and camera, blocking flash and ip discovery through WebRTC, and can automatically block ads and tracking through PIA MACE™.

Please be advised that connecting to a proxy through our extension only protects traffic from that particular browser and not on applications that may be installed on the operating system itself.


This client allows a user to sign-in to their PIA account and choose a particular proxy server to route all their browser traffic through. The client itself is has additional features such as:

  • Block Adobe flash
  • Block WebRTC IP Detection
  • Block Camera access
  • Block Microphone Access
  • Block Location access
  • Disable Network Prediction
  • Disable SafeBrowsing
  • Disable Third Party Cookies
  • Disable Website Referrer
  • Disable Hyperlink Auditing
  • Remove UTM Parameters
  • PIA MACE™ (block ads, trackers, and malicious content)
  • Allow direct connections for whitelisted sites


Please start by ensuring that all the requirements in the Installation section of this README is installed. For more information, please refer to that section.

Building the client is as simple as running the following build command in PowerShell/Terminal:

`yarn run dev` 

The unpacked extension can be installed from the following url in chrome: chrome://extensions/



  • Git (latest)
  • NodeJS 8.1.0 or greater
  • Chrome Web Browser (support for the latest two versions)

Git Please use these instructions to install Git on your computer if it is not already installed: Installing Git

NodeJS We recommend installing NodeJS via nvm on MacOS and Linux. On Windows, you can simply use the node installer found here.

Download Codebase

Using the PowerShell/Terminal:

`git clone` 

or use a graphical interface like Git Desktop to download this repository into a directory of your choosing.


The extension uses NodeJS and YARN to build itself.

To install all dependencies the extension needs to build run the following command in PowerShell/Terminal:

`yarn install` 


To build the extension, run one of the commands below in PowerShell/Terminal at the project root. When the build is finished ./builds/$browser-$build will have been created, and it can be loaded as an unpacked extension in Chrome (if using option 1 below).

option 1: (a build that makes debugging easier)

`yarn run dev` 

option 2: (a production build, that targets the webstore)

`yarn run public` 

Loading Extension

  • Enter “chrome://extensions” into Chrome’s address bar.
  • Tick “Developer Mode” if it isn’t already.
  • Click “Load unpacked extension”, and choose the path to the build directory.


Ensure that the following environment variables are set before running tests








Running tests

Simply run the yarn command

`yarn test` 

And the entire test suite will be run


Ensure that a config/oneskyauthfile.json exist before uploading translations. This file should contain the public and secret keys for your 1sky account Ensure that the ONESKY_PROJECT_ID environment variable is set

The extension supports all locales found in src/_locales . The translations are translated by the 1sky service. src/_locales/en/messages.json can be uploaded to 1sky using the following grunt task:

`yarn run translation:import` 

Translations for all locales can be downloaded with the following task:

`yarn run translation:export` 


Deploying to the Chrome Webstore

Ensure the webstore.pem file exists. Ensure the following environment variables are set before uploading to the webstore. WEBSTORE_CLIENT_ID WEBSTORE_CLIENT_SECRET WEBSTORE_REFRESH_TOKEN WEBSTORE_PUBLIC_ID WEBSTORE_INTERNAL_ID

To publish the extension onto the webstore from the command line for either internal users(eg QA) or the general public, you can run one of the following: Note: We no longer push a internal version to the chrome webstore. The following command will only build a distributable that needs to be manually distributed.

For internal users only

`yarn run qa` 

For all users

`yarn run release` 

Deploying to the Firefox Add-on Store

These instructions are still in flux. Ensure that you’ve created a web-ext api key and secret beforehand At the root of the project, run the following command yarn run public This should create a new .xpi file in builds/firefox-public that can be uploaded to the add-on store via the addons website. This is a manual process for now until an automated procedure can be established.


By contributing to this project you are agreeing to the terms stated in the Contributor License Agreement (CLA) here. For more details please see Issues and Pull Requests should use these templates: ISSUES and PULL REQUESTS


  • Robert Gleeson
  • Edward Kim
  • Brad Pfannmuller
  • Amir Malik
  • Manish Jethani
  • Pericles
  • Bogdan Pitaroiu
  • Stefan Nedelcu


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

Firefox VPN Extension — Keep a Low Browsing Profile with PIA

Get the best VPN extension for Firefox and keep your browsing habits private.

  • Get advanced in-browser privacy controls for maximum protection
  • Access your favorite content free from network restrictions
  • Avoid disruptive ads with our built-in blocker

*Requires Firefox v57+

vpn for Firefox browser

Protection For All Your Devices

Surf in Privacy with PIA’s Firefox VPN Extension

Firefox is well-known as one of the most secure browsers available. It does offer more privacy than most, but Firefox’s protection is limited. The browser doesn’t hide your IP address, which means you can still be tracked online, and get hit with targeted ads and autofill suggestions.

In addition, Firefox can’t force sites to offer secure HTTPS encrypted connections. Luckily, you can fix these issues and more by installing PIA’s Firefox VPN extension.

Compatible with: Firefox v57+

Set Up PIA’s Firefox VPN in 3 Steps

Installing PIA’s Firefox VPN extension is easy. Once you’ve completed the setup, connect to any available server. That way, you can enjoy private browsing and smooth streaming on Firefox.

Step 1

Sign up for Private Internet Access

Step 2

Step 3

Choose a server & start browsing Firefox

PIA’s Firefox VPN Extension Features

No logs policy

Block Network Prediction

Prevent Firefox from pre-selecting web pages to visit based on your viewing history.

open source vpn

Advanced Anti-Tracking

Disable link auditing, UTM blocking, and Facebook tracking with advanced obfuscation features.

Fingerprint Protection

Scramble your device fingerprint to stop websites tracking your device configuration.


Intercept obstructive ads and block malware before they reach your device with PIA’s powerful ad blocker.

open source vpn

WebRTC Protection

Patch the WebTRC exploit to keep your IP address private and leak-proof.

easy to use vpn

Force HTTPS Encryption

Add extra data security to your browsing by forcing sites to serve up HTTPS versions if they exist.

Get Device-Wide VPN Protection

Firefox is great, but sometimes you need to use other apps. PIA’s full VPN app protects every app on your device, gives you access to 147 server locations, and has an unparalleled suite of advanced security features.

Select Your Virtual Location

PIA for Firefox Vs. A Free Firefox VPN

A free Firefox VPN seems appealing at first glance, but it can put your security at risk. Let’s take a look at a few reasons why PIA for Firefox is a better option than a free VPN.

PIA VPN for Firefox

  • Includes full VPN app
  • No Logs policy
  • Server locations worldwide
  • Blocks ads
  • Blocks trackers and malware
  • WebRTC protection
  • Optimized for fast connections
  • Unlimited bandwidth and data
  • 24/7 Customer Support

Free VPN for Firefox

  • Only works in Firefox
  • May sell your data
  • Limited server locations
  • Ad-supported
  • May contain malware
  • IP may be exposed
  • Slow, unreliable connections
  • Limited data transfer
  • Little or no support

Why Choose PIA Firefox VPN


Your Firefox browsing habits are your business, PIA never tracks what you do while using our VPN.

vpn encryption

VPN Expertise

Rest easy knowing we have 10+ years of experience in creating the ultimate VPN.

easy to use vpn

100% Transparency

Check out our source code on GitHub anytime — we have nothing to hide.

unlimited bandwidth vpn


Enjoy seamless streaming on our speed-optimized NextGen server network.

open source vpn


Protect up to 10 simultaneous connections at once with every PIA VPN subscription.

easy to use vpn

24/7 Customer Support

Contact us anytime using 24/7 live chat or email to get expert Customer Support.

When Should I use the Firefox VPN Extension Vs. the VPN App?

PIA’s extension is perfect for safe searches and smooth streaming if you only need protection on Firefox.

For everything else, use our full VPN app. You get device-wide protection, access to our entire server network, and advanced security features.

Select Your Virtual Location

Trusted By Millions Of Satisfied Customers

<"tweetsBtnText":"","userBtnText":"","influencersBtnText":"","techReviewsBtnText":"">TRUSTED AND RECOMMENDED BY:

Choose The Plan That’s Right For You

All Plans Are Covered By Our 30-Day Money-Back Guarantee

Back to School Deal: 85% OFF

3 Years + 3 Months FREE

455.91€ 70€ per 3 years

140.28€ 37.19€ per year

All amounts are shown in EUR, and any discounts reflect a reduction based on the current monthly service pricing at 11.69 € per month.


3 Years + 3 Months FREE

455.91€ 70€ per 3 years

140.28€ 37.19€ per year

All amounts are shown in EUR, and any discounts reflect a reduction based on the current monthly service pricing at 11.69 € per month.


What’s the difference between a VPN add-on and a VPN app?

PIA’s Firefox browser extension is a VPN add-on that only covers Firefox. You’d need to install the relevant extension for other browsers if you want to secure them too. Either way, only your browser activity is protected.

On the other hand, PIA’s full-featured VPN protects your data and privacy across browsers, apps, and operating systems. We offer dedicated apps for iOS, Android, macOS, Windows, and Linux. PIA also works on smart devices, routers, Chromebook, and more.

Why do I need a VPN for Firefox browser?

Firefox is more private than most mainstream browsers, but it doesn’t provide complete data protection. Anyone can still stalk your online activity, harvest your browsing data, and bombard you with targeted ads — or worse.

PIA’s Firefox VPN extension prevents online tracking and those annoying ads that interrupt your browsing. Mask your IP the moment you connect to our servers and know your browsing data is wiped the second we reboot the server. No one will ever know what you’re doing online, not even us.

How does PIA VPN work on Firefox?

Just install the Firefox PIA extension, create an account, and log in. Then connect to a server to get started. We’ll encrypt your data and mask your IP address to increase your online privacy and security. You can securely access your favorite content from anywhere and enjoy ultra-fast speeds for streaming in Firefox.

I have the VPN extension, why do I also need the app?

If you want system-wide protection, you need the full VPN. The Firefox VPN extension is excellent if you simply want more privacy and security while browsing Firefox, but that’s all it covers.

For device-wide protection, you need PIA’s full VPN. It covers all the browsers, apps, and devices you use. Download VPN apps for Android, Windows, Linux, macOS, and iOS. PIA also supports routers, Smart TVs, and gaming consoles.

The best part is one PIA subscription gives you access to both the extension and the VPN app. You can still use the Firefox extension anytime you want to do a quick, private search.

What is a WebRTC leak and how does a VPN stop it?

A WebRTC leak is a common vulnerability that happens while you’re trying to establish communication using a web browser. WebRTC leaks can expose your true IP address, putting your privacy at risk.

PIA VPN masks your IP address, prevents WebRTC leaks, and provides military-grade VPN encryption to protect your data. We also provide an advanced Kill Switch that prevents any data or location leaks, even when the VPN is off. That way, your true IP address is always shielded.

What other browsers does PIA have an extension for?

PIA offers VPN extensions for Chrome and Opera, in addition to Firefox. There isn’t an extension for Safari yet, but we offer dedicated apps for iOS and macOS, so you can enjoy total privacy on all your Apple devices by installing our full VPN app.

Still Not Convinced? Try PIA Risk Free

Our 30-day money-back guarantee offers you 100% satisfaction or your money back.

vpn free trial

Disclaimer: Using PIA VPN for illegal purposes is a violation of our Terms of Service .

Private Internet Access has 10+ years of experience leading the VPN industry. With a strict no-logs policy, world-class server infrastructure, and transparent open-source software, PIA prioritizes your online privacy, security, and freedom above all else.

Follow us on social media

  • Refer a Friend
  • Affiliates
  • Influencers
  • Become a Partner
  • Vulnerability Disclosure Program
  • What’s my IP
  • DNS Leak Test
  • Email Leak Test
  • IPv6 Leak Test
  • About PIA
  • Companies we support
  • Sitemap
  • Reviews
  • Support
  • Contact us
  • Terms of Service
  • Privacy and Cookie Policy
  • DMCA Policy
  • Export Control Policy

Copyright © Private Internet Access, Inc. All Rights Reserved.