Start9/documentation
2
0
Fork 0
mirror of https://github.com/Start9Labs/documentation.git synced 2026-03-26 10:21:53 +00:00
Code Issues Packages Projects Releases Wiki Activity

navigation fixes

Browse Source
This commit is contained in:
Lucy Cifferello
2021-01-11 09:01:00 -07:00
parent 76b3c5fc73
commit b91827b1be
8 changed files with 30 additions and 114 deletions
Download Patch File Download Diff File Expand all files Collapse all files

14
source/_static/js/main.js
View File

@@ -9,11 +9,11 @@ $(document).ready(function () {
$(this).parent().children(".admonition-title").toggleClass("open");
})
});
$(window).on('load', function () {
console.log("loaded")
// $(window).on('load', function () {
// console.log("loaded")
$('a').click(function () {
console.log('tag clicked')
$("body.scrolled").addClass("set-padding")
})
})
// $('a').click(function () {
// console.log('tag clicked')
// $("body.scrolled").addClass("set-padding")
// })
// })

10
source/misc-guides/tor-firefox/android.rst
View File

@@ -16,31 +16,31 @@ Now, you need to download a `Proxy Auto Config` file that will use Orbot to reso
Next, navigate to ``about:config`` in the Firefox URL bar:
.. figure:: /_static/images/tor/about_config.png
:width: 80%
:width: 50%
: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%
:width: 50%
: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%
:width: 50%
: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%
:width: 50%
:alt: Firefox socks remote dns setting screenshot
Next, search for ``dom.securecontext.whitelist_onions`` and set the value to ``true``.
.. figure:: /_static/images/tor/firefox_whitelist_mobile.png
:width: 80%
:width: 50%
:alt: Firefox whitelist onions screenshot
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 <https://play.google.com/store/apps/details?id=com.x8bit.bitwarden&hl=en_US&gl=US>`_ native application.

2
source/misc-guides/tor-firefox/index.rst
View File

@@ -1,3 +1,5 @@
.. _configure_firefox_tor:
***************************
Configuring Firefox for Tor
***************************

14
source/misc-guides/tor-os/android.rst
View File

@@ -12,25 +12,25 @@ First, install the Tor proxy service to your system. To do so, open the play sto
Next, open the kebab menu in the upper right hand corner and select `Settings`:
.. figure:: /_static/images/tor/orbot_menu.png
:width: 80%
:width: 50%
:alt: Orbot menu
Then, make sure the options for `Start Orbot on Boot` and `Allow Background Starts` are checked:
.. figure:: /_static/images/tor/orbot_settings.png
:width: 80%
:width: 50%
:alt: Orbot settings
Go back, and tap start:
.. figure:: /_static/images/tor/orbot_start.png
:width: 80%
:width: 50%
:alt: Orbot start
Orbot will start up the Tor service. Once complete, you will see:
.. figure:: /_static/images/tor/orbot_started.png
:width: 80%
:width: 50%
:alt: Orbot started
You can now close Orbot.
@@ -45,7 +45,7 @@ This process also applies for GrapheneOS.
To setup, first disable Private DNS on your device. To do so, navigate to: ``Settings > Network & Internet > Advanced > Private DNS > Off``
.. figure:: /_static/images/tor/private_dns_off.png
:width: 80%
:width: 50%
:alt: Private DNS off
Toggle Private DNS to "off"
@@ -53,7 +53,7 @@ To setup, first disable Private DNS on your device. To do so, navigate to: ``Set
Next, launch Orbot and toggle VPN Mode on while on the main screen:
.. figure:: /_static/images/tor/orbot_vpn.png
:width: 80%
:width: 50%
:alt: Orbot vpn mode
Toggle VPN Mode to "on"
@@ -61,7 +61,7 @@ Next, launch Orbot and toggle VPN Mode on while on the main screen:
Under `Tor-Enabled Apps`, select the gear to add applications that need to be proxied through VPN mode to utilize Tor.
.. figure:: /_static/images/tor/orbot_apps.png
:width: 80%
:width: 50%
:alt: Orbot apps
Examples of applications that need this feature are:

6
source/misc-guides/tor-os/index.rst
View File

@@ -1,8 +1,8 @@
.. _running-tor:
*************************************
Running Tor on Your Phone or Computer
*************************************
***********
Running Tor
***********
Running Tor on your phone or computer enables apps that are not Tor-enabled to communicate over Tor.

11
source/user-manual/connecting.rst
View File

@@ -24,11 +24,12 @@ Below are a list of our recommended browsers for Tor:
* `Tor Browser <https://torproject.org/download/>`_ (Mac, Windows, Linux, Android)
* `Brave <https://brave.com/>`_ (Mac, Windows, Linux)
.. seealso:: :ref:`Setting up Tor on your operating system <tor-system-setup>`
.. seealso:: :ref:`Setting up Firefox with Tor <tor-firefox-setup>`
.. seealso:: `Announcing the Consulate Browser! <https://medium.com/@start9labs/announcing-the-consulate-browser-76d94a8599cb>`_
.. seealso::
:ref:`Setting up Tor for browsers <running-tor>`
:ref:`configure_firefox_tor`
`Announcing the Consulate Browser! <https://medium.com/@start9labs/announcing-the-consulate-browser-76d94a8599cb>`_
LAN

24
source/user-manuals/tor/firefox/index.rst
View File

@@ -1,24 +0,0 @@
.. _tor-firefox-setup:
*****************
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>

63
source/user-manuals/tor/index.rst
View File

@@ -1,63 +0,0 @@
.. _tor-system-setup:
**************
Setting up Tor
**************
Operating Systems
=================
Setting up Tor on your operating system enables other applications to utilize its functionality beyond Tor Browser. For example, a bitcoin wallet software that connects to a remote bitcoin node over Tor, or Firefox web browser. In the following guides, we will walk you through setting up Tor globally. That way, you can integrate other applications that use Embassy services all over Tor!
Select your operating system to get started:
.. toctree::
:maxdepth: 1
MacOS<mac>
Windows<windows>
Linux<linux>
Android<android>
.. _tor-browser-setup:
Browsers
========
To access websites that provide a Tor address (the :code:`.onion` URL), a Tor enabled browser is required.
Tor Browser
-----------
The `Tor Browser <https://torproject.org/download/>`_ works right out of the box. Simply download, launch, and plug in a :code:`.onion` URL to access a website over Tor. No extra configuration is needed. However, it is important to note that this is the least flexible option - browser extensions are not enabled, so utilizing password managers such as Bitwarden is not possible. It is also the slowest experience for ordinary web browsing due to the extra hops it makes across the internet.
Brave Browser
-------------
Alternatively, you can use `Brave <https://brave.com/>`_ to access websites over Tor. After downloading and launching, you can open a Brave Private Window with Tor by pressing :code`Option ⌥ + Command ⌘ + N`.
However, this approach is also restricting, since browser extensions are disabled in this mode as well. Ordinary web browsing is also somewhat slower in a Private Window with Tor, so you might choose to navigate between Brave browser windows for either clearnet or Tor websites. This is a somewhat less uniform experience.
Firefox Browser
---------------
Start9 recommends configuring Firefox to resolve Tor addresses. This is by far the most featureful and flexible approach. It requires a bit more work (< 5 minutes), but the resulting experience is worth the effort. It gives you the best of both worlds: you can browse clearnet websites without latency and visit Onion websites without switching browsers. And for Embassy owners, there is the added benefit of using your `Bitwarden password manager <https://medium.com/@start9labs/start9-welcomes-bitwarden-to-the-sovereign-app-store-8ad31e1a3070>`_!
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:
- :ref:`Android <firefox-tor-android>`
- :ref:`Linux <firefox-tor-linux>`
- :ref:`Mac <firefox-tor-mac>`
- :ref:`Windows <firefox-tor-windows>`
.. toctree::
:maxdepth: 1
:hidden:
Firefox <firefox/index>