mirror of
https://github.com/Start9Labs/documentation.git
synced 2026-03-26 18:31:53 +00:00
189 lines
7.9 KiB
ReStructuredText
189 lines
7.9 KiB
ReStructuredText
.. _tor-ff:
|
|
|
|
===========================
|
|
Configuring Firefox for Tor
|
|
===========================
|
|
|
|
.. tabs::
|
|
|
|
.. group-tab:: Mac
|
|
|
|
#. Ensure you are already :ref:`running Tor on your Mac <tor-mac>`.
|
|
|
|
#. Open Firefox and enter ``about:config`` in the URL bar. Accept any warnings that appear
|
|
|
|
#. Search for ``dom.securecontext.allowlist_onions`` and set the value to ``true``:
|
|
|
|
.. figure:: /_static/images/tor/firefox_allowlist.png
|
|
:width: 60%
|
|
:alt: Firefox whitelist onions screenshot
|
|
|
|
#. Go to the right-hand hamburger menu and select ``Settings``:
|
|
|
|
.. figure:: /_static/images/tor/os_ff_settings.png
|
|
:width: 30%
|
|
:alt: Firefox options screenshot
|
|
|
|
#. Search for the term ``proxy`` in the search bar in the upper right and select ``Settings...``:
|
|
|
|
.. figure:: /_static/images/tor/firefox_search.png
|
|
:width: 60%
|
|
:alt: Firefox search screenshot
|
|
|
|
#. Check the option labeled ``Use System Proxy Settings`` *and* the box labeled ``Proxy DNS when using SOCKS v5``:
|
|
|
|
.. figure:: /_static/images/tor/firefox_proxy.png
|
|
:width: 60%
|
|
:alt: Firefox proxy settings screenshot
|
|
|
|
#. Click ``OK`` and restart Firefox
|
|
|
|
#. Test that Firefox can resolve `.onion` URLs by visiting Start9's Tor website: http://privacy34kn4ez3y3nijweec6w4g54i3g54sdv7r5mr6soma3w4begyd.onion.
|
|
|
|
.. group-tab:: Windows
|
|
|
|
#. Ensure you are already :ref:`running Tor on your Windows machine <tor-windows>`.
|
|
|
|
#. Download the ``Proxy Auto Config`` file to inform Firefox how to resolve `.onion` URLs. Click `here <https://start9.com/assets/proxy.pac>`_ to get the one offered by Start9. Save it somewhere you will not delete it, and remember where you save it. For example:
|
|
|
|
.. code-block::
|
|
|
|
C:\Program Files\Tor Browser\proxy.pac
|
|
|
|
#. Open Firefox and enter ``about:config`` in the URL bar. Accept any warnings that appear
|
|
|
|
#. Search for ``dom.securecontext.allowlist_onions`` and set the value to ``true``:
|
|
|
|
.. figure:: /_static/images/tor/firefox_allowlist.png
|
|
:width: 60%
|
|
:alt: Firefox whitelist onions screenshot
|
|
|
|
#. Go to the right-hand hamburger menu and select ``Settings``:
|
|
|
|
.. figure:: /_static/images/tor/os_ff_settings.png
|
|
:width: 30%
|
|
:alt: Firefox options screenshot
|
|
|
|
#. Search for the term ``proxy`` in the search bar in the upper right and select ``Settings...``:
|
|
|
|
.. figure:: /_static/images/tor/firefox_search.png
|
|
:width: 60%
|
|
:alt: Firefox search screenshot
|
|
|
|
#. Select ``Automatic proxy configuration URL`` and paste in the path to your PAC file from earlier, prefixed with ``file://``. For example:
|
|
|
|
.. code-block::
|
|
|
|
file://C:/Program Files/Tor Browser/proxy.pac
|
|
|
|
#. Check the box labeled ``Proxy DNS when using SOCKS v5``:
|
|
|
|
.. figure:: /_static/images/tor/firefox_proxy.png
|
|
:width: 60%
|
|
:alt: Firefox proxy settings screenshot
|
|
|
|
#. Click ``OK`` and restart Firefox
|
|
|
|
#. Test that Firefox can resolve `.onion` URLs by visiting Start9's Tor website: http://privacy34kn4ez3y3nijweec6w4g54i3g54sdv7r5mr6soma3w4begyd.onion.
|
|
|
|
.. group-tab:: Linux
|
|
|
|
#. Ensure you are already :ref:`running Tor on your Linux machine <tor-linux>`.
|
|
|
|
#. Download the `Proxy Auto Config` file to inform Firefox how to resolve `.onion` URLs. You can get Start9's standard file from a terminal, by using:
|
|
|
|
.. code-block::
|
|
|
|
sudo wget -P ~/ https://start9.com/assets/proxy.pac
|
|
|
|
#. Open Firefox and enter ``about:config`` in the URL bar. Accept any warnings that appear
|
|
|
|
#. Search for ``dom.securecontext.allowlist_onions`` and set the value to ``true``:
|
|
|
|
.. figure:: /_static/images/tor/firefox_allowlist.png
|
|
:width: 60%
|
|
:alt: Firefox whitelist onions screenshot
|
|
|
|
#. Determine the full path of `proxy.pac`, which we will use in step 9, by executing the following command in the terminal, and copying its output to your clipboard:
|
|
|
|
.. code-block::
|
|
|
|
echo file://$HOME/proxy.pac
|
|
|
|
#. Go to the right-hand hamburger menu and select ``Settings``:
|
|
|
|
.. figure:: /_static/images/tor/os_ff_settings.png
|
|
:width: 30%
|
|
:alt: Firefox options screenshot
|
|
|
|
#. Search for the term ``proxy`` in the search bar in the upper right and select ``Settings...``:
|
|
|
|
.. figure:: /_static/images/tor/firefox_search.png
|
|
:width: 60%
|
|
:alt: Firefox search screenshot
|
|
|
|
#. Select ``Automatic proxy configuration URL`` and paste the output from the command you performed in step 6. Be aware, the triple ``///`` is intentional, and your path *will* be different from the one below - namely, YOUR_LINUX_USERNAME will be your actual linux username:
|
|
|
|
.. code-block::
|
|
|
|
file:///home/YOUR_LINUX_USERNAME/proxy.pac
|
|
|
|
.. figure:: /_static/images/tor/firefox_proxy_linux.png
|
|
:width: 60%
|
|
:alt: Firefox proxy settings screenshot
|
|
|
|
#. Check the box labeled ``Proxy DNS when using SOCKS v5`` in the image above
|
|
|
|
#. Click ``OK`` and restart Firefox
|
|
|
|
#. Test that Firefox can resolve `.onion` URLs by visiting Start9's Tor website: http://privacy34kn4ez3y3nijweec6w4g54i3g54sdv7r5mr6soma3w4begyd.onion.
|
|
|
|
.. group-tab:: Android
|
|
|
|
#. Ensure you are already :ref:`running Tor on your Android device <tor-android>`.
|
|
|
|
#. Download the `Proxy Auto Config` file to inform Firefox how to resolve `.onion` URLs. We have one hosted `here <https://start9.com/assets/proxy.pac>`_
|
|
|
|
#. Open Firefox and enter ``about:config`` in the URL bar. Accept any warnings that appear
|
|
|
|
#. Search for ``dom.securecontext.allowlist_onions`` and set the value to ``true``:
|
|
|
|
.. figure:: /_static/images/tor/firefox_allowlist.png
|
|
:width: 60%
|
|
:alt: Firefox whitelist onions screenshot
|
|
|
|
#. Search for ``network.proxy.autoconfig_url``, and set the value to ``file:///storage/emulated/0/Download/proxy.pac``. This is the default location of a the proxy.pac file downloaded in step 2, although your path may vary:
|
|
|
|
.. figure:: /_static/images/tor/autoconfig_url.png
|
|
:width: 30%
|
|
:alt: Firefox autoconfig url setting screenshot
|
|
|
|
#. Search for ``network.proxy.type`` into the search bar, and set the value to ``2``:
|
|
|
|
.. figure:: /_static/images/tor/network_proxy_type.png
|
|
:width: 30%
|
|
:alt: Firefox network proxy type setting screenshot
|
|
|
|
#. Search for ``network.proxy.socks_remote_dns``, and set the value to ``true``:
|
|
|
|
.. figure:: /_static/images/tor/socks_remote_dns.png
|
|
:width: 30%
|
|
:alt: Firefox socks remote dns setting screenshot
|
|
|
|
#. Search for ``dom.securecontext.allowlist_onions`` and set the value to ``true``:
|
|
|
|
.. figure:: /_static/images/tor/firefox_allowlist_mobile.png
|
|
:width: 30%
|
|
:alt: Firefox whitelist onions screenshot
|
|
|
|
#. Search for ``network.http.referer.hideOnionSource`` and set the value to ``true``
|
|
|
|
#. (**GrapheneOS users 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:
|
|
|
|
.. figure:: /_static/images/tor/storage-scopes-proxy.jpg
|
|
:width: 15%
|
|
|
|
#. Restart Firefox
|
|
|
|
#. Test that Firefox can resolve `.onion` URLs by visiting Start9's Tor website: http://privacy34kn4ez3y3nijweec6w4g54i3g54sdv7r5mr6soma3w4begyd.onion.
|