From b79a65cb931742ac78556db3d1a784df0ea24064 Mon Sep 17 00:00:00 2001 From: kn0wmad Date: Wed, 14 Apr 2021 12:44:47 -0600 Subject: [PATCH] Tor FF config reformat --- source/misc-guides/tor-firefox/android.rst | 2 +- source/misc-guides/tor-firefox/desktop.rst | 98 ++++++++++++++++++++++ source/misc-guides/tor-firefox/index.rst | 8 +- source/misc-guides/tor-firefox/ios.rst | 10 +++ source/misc-guides/tor-firefox/linux.rst | 54 ------------ source/misc-guides/tor-firefox/mac.rst | 64 -------------- source/misc-guides/tor-firefox/mobile.rst | 13 +++ source/misc-guides/tor-firefox/windows.rst | 54 ------------ source/misc-guides/tor-os/index.rst | 3 +- source/misc-guides/tor-os/ios.rst | 10 +++ source/misc-guides/tor-os/windows.rst | 4 +- 11 files changed, 139 insertions(+), 181 deletions(-) create mode 100644 source/misc-guides/tor-firefox/desktop.rst create mode 100644 source/misc-guides/tor-firefox/ios.rst delete mode 100644 source/misc-guides/tor-firefox/linux.rst delete mode 100644 source/misc-guides/tor-firefox/mac.rst create mode 100644 source/misc-guides/tor-firefox/mobile.rst delete mode 100644 source/misc-guides/tor-firefox/windows.rst create mode 100644 source/misc-guides/tor-os/ios.rst diff --git a/source/misc-guides/tor-firefox/android.rst b/source/misc-guides/tor-firefox/android.rst index c89876a..05d5df6 100644 --- a/source/misc-guides/tor-firefox/android.rst +++ b/source/misc-guides/tor-firefox/android.rst @@ -43,4 +43,4 @@ Once Tor is setup on your system, you can proceed to setup Firefox: :width: 50% :alt: Firefox whitelist onions screenshot -8. 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. \ No newline at end of file +8. 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. diff --git a/source/misc-guides/tor-firefox/desktop.rst b/source/misc-guides/tor-firefox/desktop.rst new file mode 100644 index 0000000..9f08de9 --- /dev/null +++ b/source/misc-guides/tor-firefox/desktop.rst @@ -0,0 +1,98 @@ +.. _firefox-tor-desktop: + +************************************** +Setting up Firefox with Tor on Desktop +************************************** + +.. warning:: + This guide assumes you have completed :ref:`setting up Tor`. Please visit this section first before you proceed as it is required for Firefox to properly work with Tor. + +1. Open Firefox. + +2. Enter ``about:config`` in the URL bar. Accept any warnings that may appear about accessing advanced settings. + +3. Search for ``dom.securecontext.whitelist_onions`` and set the value to ``true``. + + .. figure:: /_static/images/tor/firefox_whitelist.png + :width: 80% + :alt: Firefox whitelist onions screenshot + +On Windows, use the following proxy config file instructions: + + #. Download a `Proxy Auto Config` file that will use the Tor service to resolve .onion urls. We have one hosted `here `_. Save it somewhere you won’t delete it. For this example: + + .. code-block:: + + C:\Program Files\Tor Browser\proxy.pac + +On Mac, use the following proxy config file instructions: + + #. Open the `Terminal` App on your Mac. You can find it in your list of Applications. + + #. Enter into the terminal: + + .. code-block:: + + brew install wget + + #. And then: + + .. code-block:: + + wget -P /usr/local/etc/tor https://registry.start9labs.com/sys/proxy.pac + +On Linux, use the following proxy config file instructions: + + #. Create a `Proxy Auto Config` file (advanced) or use our standard one (recommended): + + #. From a terminal, enter: + + .. code-block:: + + sudo wget -P /etc/tor https://registry.start9labs.com/sys/proxy.pac + + +4. Now open your Firefox web browser, and select options (Windows), or preferences (Mac/Linux): + + .. figure:: /_static/images/tor/firefox_options_windows.png + :width: 80% + :alt: Firefox options screenshot + + Select :menuselection:`Settings --> Options` + + +5. Search for the term “proxy” in the search bar in the upper right, then select the button that says `Settings…`: + + .. figure:: /_static/images/tor/firefox_search.png + :width: 80% + :alt: Firefox search screenshot + +6. This should open a menu that will allow you to configure your proxy settings. Select `Automatic proxy configuration URL` and paste in the path to your PAC file from earlier, prefixed with ``file://``. For example: + +Windows: + + .. code-block:: + + file://C:/Program Files/Tor Browser/proxy.pac + +Mac: + + .. code-block:: + + file:///usr/local/etc/tor/proxy.pac + +Linux: + + .. code-block:: + + file:///etc/tor/proxy.pac + +7. Then, check the box labeled `Proxy DNS when using SOCKS v5`: + + .. figure:: /_static/images/tor/firefox_proxy.png + :width: 80% + :alt: Firefox proxy settings screenshot + +8. Click ``OK`` and then restart Firefox for the changes to take effect. + +9. 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 Firefox Plugin `_. diff --git a/source/misc-guides/tor-firefox/index.rst b/source/misc-guides/tor-firefox/index.rst index 493112b..5f4ef38 100644 --- a/source/misc-guides/tor-firefox/index.rst +++ b/source/misc-guides/tor-firefox/index.rst @@ -10,9 +10,7 @@ Configuring Firefox for Tor Once you have completed the above guide, select your device's operating system below: .. toctree:: - :maxdepth: 1 + :maxdepth: 2 - MacOS - Windows - Linux - Android \ No newline at end of file + Desktop + Mobile diff --git a/source/misc-guides/tor-firefox/ios.rst b/source/misc-guides/tor-firefox/ios.rst new file mode 100644 index 0000000..bbc1016 --- /dev/null +++ b/source/misc-guides/tor-firefox/ios.rst @@ -0,0 +1,10 @@ +.. _firefox-tor-ios: + +********************************** +Setting up Firefox with Tor on iOS +********************************** + +Unfortunately, Apple does not allow tor to be run natively on iOS. This means that Firefox cannot be configured to use tor. This leaves 2 options for iOS users: + +#. You can use Start9 Labs' own Consulate Browser, which is available `here `_. +#. You can use another Tor Browser from the app store by searching `here `_. diff --git a/source/misc-guides/tor-firefox/linux.rst b/source/misc-guides/tor-firefox/linux.rst deleted file mode 100644 index 9df525b..0000000 --- a/source/misc-guides/tor-firefox/linux.rst +++ /dev/null @@ -1,54 +0,0 @@ -.. _firefox-tor-linux: - -************************************ -Setting up Firefox with Tor on Linux -************************************ - -.. warning:: - This guide assumes you have completed :ref:`setting up Tor for Linux`. Please visit this section first before you proceed as it is required for Firefox to properly work with Tor. - -#. Open Firefox. - -#. Enter ``about:config`` in the URL bar. Accept any warnings that may appear about accessing advanced settings. - -#. Search for ``dom.securecontext.whitelist_onions`` and set the value to ``true``. - - .. figure:: /_static/images/tor/firefox_whitelist.png - :width: 80% - :alt: Firefox whitelist onions screenshot - -#. Create a `Proxy Auto Config` file (advanced) or use our standard one (recommended): - - .. code-block:: - - sudo wget -P /etc/tor https://registry.start9labs.com/sys/proxy.pac - -#. Now open your Firefox web browser, and select preferences. - - .. figure:: /_static/images/tor/firefox_preferences.png - :width: 80% - :alt: Firefox preferences screenshot - - Select :menuselection:`Settings --> Preferences` - -#. Search for the term “proxy” in the search bar in the upper right, then select the button that says `Settings…`. - - .. figure:: /_static/images/tor/firefox_search.png - :width: 80% - :alt: Firefox search screenshot - -#. This should open a menu that will allow you to configure your proxy settings. Select `Automatic proxy configuration URL` and paste in: - - .. code-block:: - - file:///etc/tor/proxy.pac - -#. Check the box labeled `Proxy DNS when using SOCKS v5`. - - .. figure:: /_static/images/tor/firefox_proxy.png - :width: 80% - :alt: Firefox proxy settings screenshot - -#. Click ``OK`` and then restart Firefox for the changes to take effect. - -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 Firefox Plugin `_. \ No newline at end of file diff --git a/source/misc-guides/tor-firefox/mac.rst b/source/misc-guides/tor-firefox/mac.rst deleted file mode 100644 index 9d8e0a7..0000000 --- a/source/misc-guides/tor-firefox/mac.rst +++ /dev/null @@ -1,64 +0,0 @@ -.. _firefox-tor-mac: - -************************************ -Setting up Firefox with Tor on MacOS -************************************ - -.. warning:: - This guide assumes you have completed :ref:`setting up Tor for MacOS`. Please visit this section first before you proceed as it is required for Firefox to properly work with Tor. - -#. Open Firefox. - -#. Enter ``about:config`` in the URL bar. Accept any warnings that may appear about accessing advanced settings. - -#. Search for ``dom.securecontext.whitelist_onions`` and set the value to ``true``. - - .. figure:: /_static/images/tor/firefox_whitelist.png - :width: 80% - :alt: Firefox whitelist onions screenshot - -#. Next, download the `Proxy Auto Config` file. This file tells Firefox which URLs to use for Tor. - - #. Open the `Terminal` App on your Mac. You can find it in your list of Applications. - - #. Enter into the terminal: - - .. code-block:: - - brew install wget - - #. And then: - - .. code-block:: - - wget -P /usr/local/etc/tor https://registry.start9labs.com/sys/proxy.pac - -#. Open your Firefox web browser, and select preferences: - - .. figure:: /_static/images/tor/firefox_preferences.png - :width: 80% - :alt: Firefox preferences screenshot - - Select :menuselection:`Settings --> Preferences` - -#. Search for the term “proxy” in the search bar in the upper right, then select the button that says `Settings…`: - - .. figure:: /_static/images/tor/firefox_search.png - :width: 80% - :alt: Firefox search screenshot - -#. This should open a menu that will allow you to configure your proxy settings. Select `Automatic proxy configuration URL` and paste in: - - .. code-block:: - - file:///usr/local/etc/tor/proxy.pac - -#. Then, check the box labeled `Proxy DNS when using SOCKS v5`: - - .. figure:: /_static/images/tor/firefox_proxy.png - :width: 80% - :alt: Firefox proxy settings screenshot - -#. Click ``OK`` and then restart Firefox for the changes to take effect. - -#. 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 Firefox Plugin `_. \ No newline at end of file diff --git a/source/misc-guides/tor-firefox/mobile.rst b/source/misc-guides/tor-firefox/mobile.rst new file mode 100644 index 0000000..9b290f6 --- /dev/null +++ b/source/misc-guides/tor-firefox/mobile.rst @@ -0,0 +1,13 @@ +.. _firefox-tor-mobile: + +************************************** +Setting up Firefox with Tor on Mobile +************************************** + +If you are on Android, you can continue after setting up Tor on your device. If you are on iOS, click below for your options. + +.. toctree:: + :maxdepth: 1 + + Android + iOS diff --git a/source/misc-guides/tor-firefox/windows.rst b/source/misc-guides/tor-firefox/windows.rst deleted file mode 100644 index f4a4cdd..0000000 --- a/source/misc-guides/tor-firefox/windows.rst +++ /dev/null @@ -1,54 +0,0 @@ -.. _firefox-tor-windows: - -************************************** -Setting up Firefox with Tor on Windows -************************************** - -.. warning:: - This guide assumes you have completed :ref:`setting up Tor for Windows`. Please visit this section first before you proceed as it is required for Firefox to properly work with Tor. - -#. Open Firefox. - -#. Enter ``about:config`` in the URL bar. Accept any warnings that may appear about accessing advanced settings. - -#. Search for ``dom.securecontext.whitelist_onions`` and set the value to ``true``. - - .. figure:: /_static/images/tor/firefox_whitelist.png - :width: 80% - :alt: Firefox whitelist onions screenshot - -#. Download a `Proxy Auto Config` file that will use the Tor service to resolve .onion urls. We have one hosted `here `_. Save it somewhere you won’t delete it. For this example: - - .. code-block:: - - C:\Program Files\Tor Browser\proxy.pac - -#. Now open your Firefox web browser, and select options: - - .. figure:: /_static/images/tor/firefox_options_windows.png - :width: 80% - :alt: Firefox options screenshot - - Select :menuselection:`Settings --> Options` - -#. Search for the term “proxy” in the search bar in the upper right, then select the button that says `Settings…`: - - .. figure:: /_static/images/tor/firefox_search.png - :width: 80% - :alt: Firefox search screenshot - -#. This should open a menu that will allow you to configure your proxy settings. 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: 80% - :alt: Firefox proxy settings screenshot - -#. Click ``OK`` and then restart Firefox for the changes to take effect. - -#. 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 Firefox Plugin `_. \ No newline at end of file diff --git a/source/misc-guides/tor-os/index.rst b/source/misc-guides/tor-os/index.rst index 328c50c..6bdd88b 100644 --- a/source/misc-guides/tor-os/index.rst +++ b/source/misc-guides/tor-os/index.rst @@ -14,4 +14,5 @@ Select your operating system to get started: MacOS Windows Linux - Android \ No newline at end of file + Android + iOS diff --git a/source/misc-guides/tor-os/ios.rst b/source/misc-guides/tor-os/ios.rst new file mode 100644 index 0000000..4bb6b26 --- /dev/null +++ b/source/misc-guides/tor-os/ios.rst @@ -0,0 +1,10 @@ +.. _firefox-tor-ios: + +********************* +Setting up Tor on iOS +********************* + +Unfortunately, Apple does not allow tor to be run natively on iOS. This means that Firefox cannot be configured to use tor. This leaves 2 options for iOS users: + +#. You can use Start9 Labs' own Consulate Browser, which is available `here `_. +#. You can use another Tor Browser from the app store by searching `here `_. diff --git a/source/misc-guides/tor-os/windows.rst b/source/misc-guides/tor-os/windows.rst index 4b9284f..133a5ba 100644 --- a/source/misc-guides/tor-os/windows.rst +++ b/source/misc-guides/tor-os/windows.rst @@ -12,7 +12,7 @@ Running Tor on Windows Download Tor for Windows -#. Once it is downloaded, go ahead and run the installer. If you want to install the program outside of your user directory, you will have to right click and select `Run as Administrator`. +#. Once it is downloaded, go ahead and run the installer. If you want to install the program outside of your user directory, you will have to right click and select `Run as Administrator`. #. Once you have selected a language, you should see a menu like this: @@ -43,4 +43,4 @@ Running Tor on Windows Replace highlighted section with noted destination folder -#. That's it! Your Windows computer is now setup to natively use Tor. \ No newline at end of file +#. That's it! Your Windows computer is now setup to natively use Tor.