add instructions for tor setup on all systems and for firefox

source/user-manuals/tor/firefox/android.rst

@@ -0,0 +1,42 @@
+.. _firefox-tor-android:
+
+**************************************
+Setting up Firefox with Tor on Android
+**************************************
+
+.. warning::
+  This guide assumes you have completed :ref:`setting up Tor for Android<tor-android>`. Please visit this section first before you proceed as it is required for Firefox to properly work with Tor.
+
+Once Tor is setup on your system, you can proceed to setup Firefox.
+
+Download `Firefox Beta <https://play.google.com/store/apps/details?id=org.mozilla.firefox_beta>`_ from the Play Store, or Fennec for F-Droid.
+
+Now, you need to download a `Proxy Auto Config` file that will use Orbot to resolve :code:`.onion` URLs. We have one hosted `here <https://registry.start9labs.com/sys/proxy.pac>`_.
+
+Next, navigate to :code:`about:config` in the Firefox URL bar, like so:
+
+.. figure:: /_static/images/tor/about_config.png
+  :width: 80%
+  :alt: Firefox about config
+
+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: 80%
+  :alt: Firefox network proxy type setting screenshot
+
+Then, search for ``“network.proxy.autoconfig_url”``, and set the value to ``"file:///storage/emulated/0/Download/proxy.pac"``:
+
+.. figure:: /_static/images/tor/autoconfig_url.png
+  :width: 80%
+  :alt: Firefox autoconfig url setting screenshot
+
+Next, search for ``“network.proxy.socks_remote_dns”``, and set the value to ``"true"``:
+
+.. figure:: /_static/images/tor/socks_remote_dns.png
+  :width: 80%
+  :alt: Firefox socks remote dns setting screenshot
+
+Finally, search for ``“dom.securecontext.whitelist_onions”``, and set the value to ``"true"``:
+
+Restart Firefox, and you’re all set! You should now be able to navigate to :code:`.onion` URLs in Firefox. This means you can bookmark Cups Messenger, and use your Bitwarden Tor address in the `Bitwarden Password Manager <https://play.google.com/store/apps/details?id=com.x8bit.bitwarden&hl=en_US&gl=US>`_ native application.

source/user-manuals/tor/firefox/index.rst

@@ -0,0 +1,22 @@
+*****************
+Firefox Tor Setup
+*****************
+
+.. warning::
+  These guides assume you have completed :ref:`setting up Tor for your operating system<tor-system-setup>`. Please visit this section first before you proceed as it is required for Firefox to properly work with Tor.
+
+After completing the steps above to setup Tor on your operating system:
+
+#. Go to :code:`about:config` in the URL bar.
+#. Accept any warnings that may appear about accessing advanced settings.
+#. Search for :code:`dom.securecontext.whitelist_onions` and set the value to :code:`true`.
+#. Restart Firefox.
+#. Select your platform below to complete setup:
+
+.. toctree::
+  :maxdepth: 1
+
+  Android <android>
+  Mac <mac>
+  Linux <linux>
+  Windows <windows>

source/user-manuals/tor/firefox/linux.rst

@@ -0,0 +1,46 @@
+.. _firefox-tor-linux:
+
+************************************
+Setting up Firefox with Tor on Linux
+************************************
+
+.. warning::
+  This guide assumes you have completed :ref:`setting up Tor for Linux<tor-linux>`. Please visit this section first before you proceed as it is required for Firefox to properly work with Tor.
+
+Once Tor is setup on your system, you can proceed to setup Firefox.
+
+Next, in order to tell Firefox which urls to use Tor for, you need a `Proxy Auto Config` file. We have one hosted `here <https://registry.start9labs.com/sys/proxy.pac>`_. To get it, you can run:
+
+.. 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
+
+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 :code:`OK` and then restart Firefox for the changes to take effect.
+
+Now you’re all set! You should now be able to navigate to :code:`.onion` URLs in Firefox. This means you can bookmark Cups Messenger, and use your Bitwarden Tor address in the `Bitwarden Firefox Plugin <https://addons.mozilla.org/en-US/firefox/addon/bitwarden-password-manager/>`_.

source/user-manuals/tor/firefox/mac.rst

@@ -0,0 +1,51 @@
+.. _firefox-tor-mac:
+
+************************************
+Setting up Firefox with Tor on MacOS
+************************************
+
+.. warning::
+  This guide assumes you have completed :ref:`setting up Tor for MacOS<tor-mac>`. Please visit this section first before you proceed as it is required for Firefox to properly work with Tor.
+
+Once Tor is setup on your system, you can proceed to setup Firefox.
+
+In order to tell Firefox which URLs to use Tor for, you need a `Proxy Auto Config` file. We have one hosted `here <https://registry.start9labs.com/sys/proxy.pac>`_. To get it, run:
+
+.. code-block::
+
+  brew install wget
+
+And then:
+
+.. code-block::
+
+  wget -P /usr/local/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:///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 :code:`OK` and then restart Firefox for the changes to take effect.
+
+Now you’re all set! You should now be able to navigate to :code:`.onion` URLs in Firefox. This means you can bookmark Cups Messenger, and use your Bitwarden Tor address in the `Bitwarden Firefox Plugin <https://addons.mozilla.org/en-US/firefox/addon/bitwarden-password-manager/>`_.

source/user-manuals/tor/firefox/windows.rst

@@ -0,0 +1,46 @@
+.. _firefox-tor-windows:
+
+**************************************
+Setting up Firefox with Tor on Windows
+**************************************
+
+.. warning::
+  This guide assumes you have completed :ref:`setting up Tor for Windows<tor-windows>`. Please visit this section first before you proceed as it is required for Firefox to properly work with Tor.
+
+Once Tor is setup on your system, you can proceed to setup Firefox.
+
+Now, you need to download a `Proxy Auto Config` file that will use the Tor service to resolve .onion urls. We have one hosted `here <https://registry.start9labs.com/sys/proxy.pac>`_. 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
+
+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 :code:`OK` and then restart Firefox for the changes to take effect.
+
+Now you’re all set! You should now be able to navigate to :code:`.onion` URLs in Firefox. This means you can bookmark Cups Messenger, and use your Bitwarden Tor address in the `Bitwarden Firefox Plugin <https://addons.mozilla.org/en-US/firefox/addon/bitwarden-password-manager/>`_.