Configuring Firefox for 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.


For some platforms, such as Calyx/Graphene on a Pixel 5/6, it may be necessary to place the file within the application’s data folder, such as file:///storage/emulated/0/Android/data/org.mozilla.firefox_beta/files/Download/proxy.pac. Furthermore, the stock file explorer app may not let you do this, so you might have to get a new one, such as Explorer. Please reach out to support if you have issues.

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.allowlist_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, or other Embassy .onion addresses, as well as use the Bitwarden browser extension.