mirror of
https://github.com/Start9Labs/documentation.git
synced 2026-03-30 20:14:50 +00:00
Tor FF config reformat
This commit is contained in:
kn0wmad
98
source/misc-guides/tor-firefox/desktop.rst
Normal file
98
source/misc-guides/tor-firefox/desktop.rst
Normal file
@@ -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<running-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 <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
|
||||||
|
|
||||||
|
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 <https://addons.mozilla.org/en-US/firefox/addon/bitwarden-password-manager/>`_.
|
||||||
@@ -10,9 +10,7 @@ Configuring Firefox for Tor
|
|||||||
Once you have completed the above guide, select your device's operating system below:
|
Once you have completed the above guide, select your device's operating system below:
|
||||||
|
|
||||||
.. toctree::
|
.. toctree::
|
||||||
:maxdepth: 1
|
:maxdepth: 2
|
||||||
|
|
||||||
MacOS <mac>
|
Desktop<desktop>
|
||||||
Windows <windows>
|
Mobile<mobile>
|
||||||
Linux <linux>
|
|
||||||
Android <android>
|
|
||||||
|
|||||||
10
source/misc-guides/tor-firefox/ios.rst
Normal file
10
source/misc-guides/tor-firefox/ios.rst
Normal file
@@ -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 <https://apps.apple.com/us/app/start9-consulate-browser/id1528124570>`_.
|
||||||
|
#. You can use another Tor Browser from the app store by searching `here <https://www.apple.com/us/search/onion-browser?src=serp>`_.
|
||||||
@@ -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<tor-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 <https://addons.mozilla.org/en-US/firefox/addon/bitwarden-password-manager/>`_.
|
|
||||||
@@ -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<tor-mac>`. 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 <https://addons.mozilla.org/en-US/firefox/addon/bitwarden-password-manager/>`_.
|
|
||||||
13
source/misc-guides/tor-firefox/mobile.rst
Normal file
13
source/misc-guides/tor-firefox/mobile.rst
Normal file
@@ -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<android>
|
||||||
|
iOS<ios>
|
||||||
@@ -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<tor-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 <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
|
|
||||||
|
|
||||||
#. 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 <https://addons.mozilla.org/en-US/firefox/addon/bitwarden-password-manager/>`_.
|
|
||||||
@@ -15,3 +15,4 @@ Select your operating system to get started:
|
|||||||
Windows<windows>
|
Windows<windows>
|
||||||
Linux<linux>
|
Linux<linux>
|
||||||
Android<android>
|
Android<android>
|
||||||
|
iOS<ios>
|
||||||
|
|||||||
10
source/misc-guides/tor-os/ios.rst
Normal file
10
source/misc-guides/tor-os/ios.rst
Normal file
@@ -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 <https://apps.apple.com/us/app/start9-consulate-browser/id1528124570>`_.
|
||||||
|
#. You can use another Tor Browser from the app store by searching `here <https://www.apple.com/us/search/onion-browser?src=serp>`_.
|
||||||
Reference in New Issue
Block a user