mirror of
https://github.com/Start9Labs/documentation.git
synced 2026-03-31 04:23:41 +00:00
About, Contribute, concepts, other edits
This commit is contained in:
kn0wmad
@@ -4,31 +4,6 @@
|
||||
Basic Configuration - ***NEEDS BUG REPORT LINK***
|
||||
===================
|
||||
|
||||
.. _device-name:
|
||||
|
||||
Set Device Name
|
||||
---------------
|
||||
|
||||
Here you can change the name of your Embassy!
|
||||
|
||||
1. Go to the ``Embassy`` tab on the main menu on the left side of the UI
|
||||
|
||||
.. figure:: /_static/images/config/basic-config0.png
|
||||
:width: 60%
|
||||
:alt: Embassy Tab
|
||||
|
||||
2. Under the ``Settings`` section, click ``Preferences``
|
||||
|
||||
.. figure:: /_static/images/config/basic-config1.png
|
||||
:width: 60%
|
||||
:alt: Preferences
|
||||
|
||||
3. Then click ``Device Name``, set to desired name, and click ``Save``
|
||||
|
||||
.. figure:: /_static/images/config/basic-config2.png
|
||||
:width: 60%
|
||||
:alt: Rename Embassy
|
||||
|
||||
.. _auto-reporting:
|
||||
|
||||
Automatically Report Bugs
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
Configuration
|
||||
=============
|
||||
|
||||
Configuration, setup guides, and known limitations are provided here by device
|
||||
Configuration, setup guides, and known limitations are provided here by device.
|
||||
|
||||
.. toctree::
|
||||
:maxdepth: 2
|
||||
|
||||
@@ -4,4 +4,4 @@
|
||||
Mac Known Limitations
|
||||
=====================
|
||||
|
||||
MacOS has no known limitations in regard to Embassy.
|
||||
MacOS has no known limitations in regard to Embassy at this time.
|
||||
|
||||
@@ -3,3 +3,7 @@
|
||||
=========================
|
||||
Windows Known Limitations
|
||||
=========================
|
||||
|
||||
Windows10 has no known limitations in regard to Embassy at this time.
|
||||
|
||||
No testing has been done with other versions, such as Windows 7 or 11.
|
||||
|
||||
@@ -4,7 +4,7 @@
|
||||
Android - ***NEEDS UPDATED***
|
||||
=======
|
||||
|
||||
.. warning::
|
||||
.. caution::
|
||||
This guide assumes you have completed :ref:`setting up Tor for Android<tor-android>`. Please visit this section before proceeding as it is required for Firefox to properly work with Tor.
|
||||
|
||||
Once Tor is setup on your system, you can proceed to setup Firefox:
|
||||
|
||||
@@ -1,17 +1,9 @@
|
||||
.. _torff-ios:
|
||||
|
||||
===
|
||||
iOS -***NEEDS UPDATED***
|
||||
iOS
|
||||
===
|
||||
|
||||
NO TOR FOR YOU
|
||||
|
||||
.. _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 the following options for iOS users:
|
||||
Unfortunately, Apple does not allow tor to be run natively on iOS. This means that Firefox cannot be configured to use tor. This leaves the following options:
|
||||
|
||||
You can use Start9's own Consulate Browser, which is available `here <https://apps.apple.com/us/app/start9-consulate-browser/id1528124570>`_, or you can select another Tor Browser by searching the `App Store <https://www.apple.com/us/search/onion-browser?src=serp>`_.
|
||||
|
||||
@@ -4,8 +4,7 @@
|
||||
Linux - ***NEEDS UPDATED***
|
||||
=====
|
||||
|
||||
|
||||
.. warning::
|
||||
.. caution::
|
||||
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.
|
||||
|
||||
@@ -1,11 +1,10 @@
|
||||
.. _torff-mac:
|
||||
|
||||
===
|
||||
Mac - ***NEEDS UPDATED***
|
||||
Mac
|
||||
===
|
||||
|
||||
|
||||
.. warning::
|
||||
.. caution::
|
||||
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.
|
||||
|
||||
@@ -1,96 +1,53 @@
|
||||
.. _torff-windows:
|
||||
|
||||
=======
|
||||
Windows - *** NEEDS UPDATED***
|
||||
Windows
|
||||
=======
|
||||
|
||||
|
||||
.. warning::
|
||||
.. caution::
|
||||
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.
|
||||
#. Open Firefox and enter ``about:config`` in the URL bar. Accept any warnings that may appear about accessing advanced settings.
|
||||
|
||||
2. 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``.
|
||||
|
||||
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
|
||||
|
||||
.. figure:: /_static/images/tor/firefox_whitelist.png
|
||||
:width: 80%
|
||||
:alt: Firefox whitelist onions screenshot
|
||||
#. Download a `Proxy Auto Config` file to inform Firefox how to use the Tor daemon running on your computer. You can get Start9's standard file by following instructions below:
|
||||
|
||||
4. Download a `Proxy Auto Config` file to inform Firefox how to use the Tor daemon running on your computer. You can get Start9's standard file by following the OS-specific instructions below:
|
||||
Windows:
|
||||
|
||||
Click `here <https://registry.start9labs.com/sys/proxy.pac>`_ to get the file and save the file somewhere you won’t delete it. Please remember the location you save the file in if you do not use our example location. For this example:
|
||||
- Click `here <https://registry.start9labs.com/sys/proxy.pac>`_ to get the file and save the file somewhere you won’t delete it. Please remember the location you save the file in if you do not use our example location. For this example:
|
||||
|
||||
.. code-block::
|
||||
|
||||
C:\Program Files\Tor Browser\proxy.pac
|
||||
|
||||
Mac:
|
||||
#. Now open your Firefox web browser, and select ``Settings -> Options``:
|
||||
|
||||
Open the ``Terminal`` App on your Mac. You can find it in your list of Applications. In the terminal, enter:
|
||||
|
||||
.. code-block::
|
||||
|
||||
brew install wget
|
||||
|
||||
And then:
|
||||
|
||||
.. code-block::
|
||||
|
||||
wget -P /usr/local/etc/tor https://registry.start9labs.com/sys/proxy.pac
|
||||
|
||||
Linux:
|
||||
|
||||
From a terminal, enter:
|
||||
|
||||
.. code-block::
|
||||
|
||||
sudo wget -P /etc/tor https://registry.start9labs.com/sys/proxy.pac
|
||||
.. figure:: /_static/images/tor/firefox_options_windows.png
|
||||
:width: 80%
|
||||
:alt: Firefox options screenshot
|
||||
|
||||
|
||||
5. Now open your Firefox web browser, and select options (Windows), or preferences (Mac/Linux):
|
||||
#. 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_options_windows.png
|
||||
:width: 80%
|
||||
:alt: Firefox options screenshot
|
||||
.. figure:: /_static/images/tor/firefox_search.png
|
||||
:width: 80%
|
||||
:alt: Firefox search screenshot
|
||||
|
||||
Select :menuselection:``Settings --> Options``
|
||||
|
||||
|
||||
6. 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
|
||||
|
||||
7. 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:
|
||||
#. 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
|
||||
|
||||
Mac:
|
||||
#. Then, check the box labeled ``Proxy DNS when using SOCKS v5``:
|
||||
|
||||
.. code-block::
|
||||
.. figure:: /_static/images/tor/firefox_proxy.png
|
||||
:width: 80%
|
||||
:alt: Firefox proxy settings screenshot
|
||||
|
||||
file:///usr/local/etc/tor/proxy.pac
|
||||
|
||||
Linux:
|
||||
|
||||
.. code-block::
|
||||
|
||||
file:///etc/tor/proxy.pac
|
||||
|
||||
8. 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
|
||||
|
||||
9. Click ``OK`` and then restart Firefox for the changes to take effect.
|
||||
|
||||
10. 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/>`_.
|
||||
#. 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. You can test by going to Start9's ``.onion`` homepage, `here <http://privacy34kn4ez3y3nijweec6w4g54i3g54sdv7r5mr6soma3w4begyd.onion/>`_. This means you can access tor-only service :ref:`WebUIs <webui>`, such as Cups Messenger, and use your Bitwarden Tor address in the `Bitwarden Firefox Plugin <https://addons.mozilla.org/en-US/firefox/addon/bitwarden-password-manager/>`_.
|
||||
|
||||
@@ -29,8 +29,8 @@ Install the Tor proxy service to your system. To do so, open your terminal and r
|
||||
|
||||
sudo systemctl restart tor
|
||||
|
||||
Arch
|
||||
----
|
||||
Arch / Manjaro
|
||||
--------------
|
||||
|
||||
Simply install Tor with:
|
||||
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
.. _wifi:
|
||||
|
||||
===============
|
||||
Setting up WiFi - ***VERIFY CONNECTION BEHAVIOR***
|
||||
Setting up WiFi - ***VERIFY CONNECTION BEHAVIOR and UPDATE FINAL SCREEN***
|
||||
===============
|
||||
|
||||
You can connect your Embassy with a wireless connection if you prefer. Follow the directions below to connect to a WiFi network, or save your credentials for later to connect to a network you are not currently in proximity to.
|
||||
|
||||
Reference in New Issue
Block a user