From 318243903e3d23f1b0bc18e6c9946284ac33bf6d Mon Sep 17 00:00:00 2001 From: BitcoinMechanic <45926711+BitcoinMechanic@users.noreply.github.com> Date: Tue, 21 Feb 2023 17:22:37 -0800 Subject: [PATCH] add graphene instructions (#297) * add graphene instructions * remove calyx from link, explain that it's not known to work * mention lineage too * better wording * recommend regular firefox - not beta --- .../connecting-tor/tor-firefox/index.rst | 2 +- .../tor-firefox/torff-android.rst | 54 ++++++++++--------- 2 files changed, 30 insertions(+), 26 deletions(-) diff --git a/site/source/user-manual/connecting/connecting-tor/tor-firefox/index.rst b/site/source/user-manual/connecting/connecting-tor/tor-firefox/index.rst index 8a6b437..844973c 100644 --- a/site/source/user-manual/connecting/connecting-tor/tor-firefox/index.rst +++ b/site/source/user-manual/connecting/connecting-tor/tor-firefox/index.rst @@ -14,5 +14,5 @@ Once you have completed native :ref:`Tor Setup`, you can configure Firef Linux Mac Windows - Android/Calyx/Graphene + Android/Graphene iOS diff --git a/site/source/user-manual/connecting/connecting-tor/tor-firefox/torff-android.rst b/site/source/user-manual/connecting/connecting-tor/tor-firefox/torff-android.rst index e0cbd3f..e2e2b88 100644 --- a/site/source/user-manual/connecting/connecting-tor/tor-firefox/torff-android.rst +++ b/site/source/user-manual/connecting/connecting-tor/tor-firefox/torff-android.rst @@ -7,45 +7,49 @@ Configuring Firefox for Tor on Android .. caution:: This guide assumes you have completed :ref:`setting up Tor for Android`. Please visit this section before proceeding as it is required for Firefox to properly work with Tor. +.. note:: Setups may strongly vary across different Android forks. We have made specific mention of GrapheneOS which has been tested on Pixel 5 and Pixel 6. Configuring Firefox for Tor is not currently possible on CalyxOS or LineageOS v20. + 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. +#. Download `Firefox `_ 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 `_. +#. 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. +#. Navigate to ``about:config`` in the Firefox URL bar. - .. figure:: /_static/images/tor/about_config.png - :width: 50% - :alt: Firefox about config + .. figure:: /_static/images/tor/about_config.png + :width: 50% + :alt: Firefox about config -4. 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``. +#. 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``. - .. figure:: /_static/images/tor/network_proxy_type.png - :width: 50% - :alt: Firefox network proxy type setting screenshot + .. figure:: /_static/images/tor/network_proxy_type.png + :width: 50% + :alt: Firefox network proxy type setting screenshot -5. Search for ``network.proxy.autoconfig_url``, and set the value to ``file:///storage/emulated/0/Download/proxy.pac``. +#. (This step is for GrapheneOS only): Head to *Settings -> Apps -> Firefox Beta -> Permissions -> Photos and videos -> Configure Storage Scopes -> ADD FILE* then navigate to where you placed the proxy.pac file. - .. caution:: No variation of this will work on LineageOS. 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 `Ghost Commander ` (also available on F-Droid). Please reach out to support if you have issues. + .. figure:: /_static/images/tor/storage-scopes-proxy.png + :width: 30% - .. figure:: /_static/images/tor/autoconfig_url.png - :width: 50% - :alt: Firefox autoconfig url setting screenshot +#. (All users): Search for ``network.proxy.autoconfig_url``, and set the value to ``file:///storage/emulated/0/Download/proxy.pac``. -6. Search for ``network.proxy.socks_remote_dns``, and set the value to ``true``. + .. figure:: /_static/images/tor/autoconfig_url.png + :width: 50% + :alt: Firefox autoconfig url setting screenshot - .. figure:: /_static/images/tor/socks_remote_dns.png - :width: 50% - :alt: Firefox socks remote dns setting screenshot +#. Search for ``network.proxy.socks_remote_dns``, and set the value to ``true``. -7. Search for ``dom.securecontext.allowlist_onions`` and set the value to ``true``. + .. figure:: /_static/images/tor/socks_remote_dns.png + :width: 50% + :alt: Firefox socks remote dns setting screenshot - .. figure:: /_static/images/tor/firefox_allowlist_mobile.png - :width: 50% - :alt: Firefox whitelist onions screenshot +#. Search for ``dom.securecontext.allowlist_onions`` and set the value to ``true``. -8. Optional but recommended: search for ``network.http.referer.hideOnionsSource`` and set the value to ``true``. + .. figure:: /_static/images/tor/firefox_allowlist_mobile.png + :width: 50% + :alt: Firefox whitelist onions screenshot -9. 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. +#. Optional but recommended: search for ``network.http.referer.hideOnionsSource`` and set the value to ``true``. +#. 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 :ref:`Bitwarden` browser extension. \ No newline at end of file