You are not reading the latest stable version of this documentation. If you want up-to-date information, please have a look at master.

Setting up Firefox with Tor on Android


This guide assumes you have completed setting up Tor for Android. Please visit this section before proceeding as it is required for Firefox to properly work with Tor.

Once Tor is setup on your system, you can proceed to setup Firefox:

  1. Download Firefox Beta from the Play Store, or Fennec from F-Droid.

  2. Next, download a Proxy Auto Config file that will use Orbot to resolve .onion URLs. We have one hosted here.

  3. Navigate to about:config in the Firefox URL bar.

Firefox about config
  1. You are going to have to change a few options in here. First, type network.proxy.type into the search bar, and set the value to 2.

Firefox network proxy type setting screenshot
  1. Search for network.proxy.autoconfig_url, and set the value to file:///storage/emulated/0/Download/proxy.pac.

Firefox autoconfig url setting screenshot
  1. Search for network.proxy.socks_remote_dns, and set the value to true.

Firefox socks remote dns setting screenshot
  1. Search for dom.securecontext.whitelist_onions and set the value to true.

Firefox whitelist onions screenshot
  1. Restart Firefox, and you’re all set! You should now be able to navigate to .onion URLs in Firefox. This means you can bookmark Cups Messenger, and use your Bitwarden Tor address in the Bitwarden Password Manager native application.