FoxyProxy Browser Extension

About (Changelog) | Help | Issues

After some years of stability, FoxyProxy has been updated to support Manifest Version 3 which is required by Chrome in order for extensions to be compatible with Chrome in 2024. We took advantage of this forced update to implement many feature requests and other changes that were requested over the years.

FoxyProxy has been owned and developed consistently by the same team since 2006.

The repository has the source code for version 8.0+ for Firefox, Chrome, and other Chromium-based browsers like Chromium, Brave and Edge.
Source code for older versions.

Permissions

downloads

Used to save/export user preferences to file, for backup or sharing

notifications

Used to inform users (e.g. for errors)

proxy

Used to set proxies (core function of the extension)

storage

Used to store user preferences

tabs

Used to get tab details (e.g. for "Quick Add", "Tab Proxy", & "Incognito/Container Proxy")

webRequest

Used to provide proxy authentication

webRequestAuthProvider

Used to provide proxy authentication

host permission

Used to provide proxy authentication (to any URL `""`)

Optional Permissions

browsingData

Used for "Delete Browsing Data" button to delete cookies, indexedDB, and localStorage, only if requested by the user

privacy

Used for "Limit WebRTC" button to toggle `browser.privacy.network.webRTCIPHandlingPolicy`, only if requested by the user

Remote Code

No remote code is used in this extension.

Screenshots

Dark Theme

Light Theme

Releases

	Chrome	Firefox	Edge
Standard
Basic

Source Code

Beta	Release	Old
	Releases	3.0.7.1	7.5.1

Browser Minimum

version	Chrome/Edge	Firefox	Firefox for Android
8.0 - 8.10	version 108 (released 2022-11-29)	version 93 (released 2021-10-05)	version 113 (manifest) (API minimum 102)
9.0 - *	version 108 (released 2022-11-29)	version 128 (released 2024-07-09) due to root certificate expiry 2025-03-14	version 128 (released 2024-07-09) due to root certificate expiry 2025-03-14

Beta Installation Guide

• Backup your FoxyProxy settings

• Download repo (or use git)

  • browser-extension (this page) -> Code (green button) -> Download ZIP
  • Unzip the downloaded file

• Chrome

  • Go to chrome://extensions/
  • Enable Developer Mode (top right)
  • Click "Load Unpacked"
  • Select manifest.json (or src folder)

• Firefox (Nightly/Beta/Developer Edition)

  • Go to about:debugging#/runtime/this-firefox
  • Click "Load Temporary Add-on..."
  • Select manifest.json

• Firefox for Android

  • Install Firefox Nightly
    • Firefox Nightly for Developers
  • Enable Debug Menu
    • Go to: menu -> Settings -> About Firefox Nightly
    • Tap a few times on the Firefox icon to enable debug menu
    • Go to: about:config
    • Find xpinstall.signatures.required
    • Toggle to false
  • Install Beta version
    • Prepare src for Firefox as mentioned above
    • Create a zip file from the content of src
    • Make the file available to the Android device
  • Install add-on from file
    • Go to: menu -> Settings -> Advanced -> Install add-on from file

Building for Distribution on the Chrome, Edge, and Firefox web stores

Version 9.0 and above

• FoxyProxy Standard: remove manifes-basic.json
• FoxyProxy Baisc: remove manifes.json, and rename manifes-basic.json to manifes.json
• zip the contents of the src directory into the top of an archive.
  The src/ directory should not be in the zip archive.

Version 8.0 to 8.10: without grunt:

• copy the appropriate manifest-xxx.json file to manifest.json; e.g. mv manifest-chrome.json manifest.json
• zip the contents of the src directory into the top of an archive.
  The src/ directory should not be in the zip archive.

Version 8.0 to 8.10: with grunt:

• Install grunt locally:
  • npm i -D grunt-cli
• Run one of:
  • grunt --target=chrome-standard
  • grunt --target=chrome-basic
  • grunt --target=firefox-standard
  • grunt --target=firefox-basic

The target is built in foxyproxy-XXX-YYY.zip; e.g. foxyproxy-chrome-standard.zip.