From 8f44e2e936c30cf0eedf0259d547fada4daa6de4 Mon Sep 17 00:00:00 2001 From: kn0wmad Date: Wed, 8 Dec 2021 15:41:03 -0700 Subject: [PATCH] Initial Setup and device guide edits --- .../dev-faq/faq-service-packaging.rst | 5 ++- source/index.rst | 4 +-- .../configuration/limitations/lim-android.rst | 14 ++++++-- .../configuration/limitations/lim-ios.rst | 22 +++++++++++-- .../configuration/limitations/lim-linux.rst | 8 +++-- .../configuration/limitations/lim-mac.rst | 15 ++------- .../configuration/limitations/lim-windows.rst | 6 ++-- .../device-guides/dg-android.rst | 18 ++++++++++ .../getting-started/device-guides/dg-ios.rst | 9 +++++ .../device-guides/dg-linux.rst | 33 +++++++++++++++++-- .../getting-started/device-guides/dg-mac.rst | 28 ++++++++++++---- .../device-guides/dg-windows.rst | 27 +++++++++++++++ .../getting-started/initial-setup.rst | 2 +- 13 files changed, 154 insertions(+), 37 deletions(-) diff --git a/source/dev-docs/dev-faq/faq-service-packaging.rst b/source/dev-docs/dev-faq/faq-service-packaging.rst index d5fcf83..02851e8 100644 --- a/source/dev-docs/dev-faq/faq-service-packaging.rst +++ b/source/dev-docs/dev-faq/faq-service-packaging.rst @@ -12,15 +12,18 @@ What considerations are there when choosing a service for packaging? -------------------------------------------------------------------- There are several things you will want to consider. Requirements include: -#. Most importantly, pick a service you are passionate about seeing on EmbassyOS. +#. Most importantly, pick a service you are passionate about seeing on EmbassyOS #. Make sure it is :ref:`Open Source ` Recommendations that may ease the process: #. A service that has already been 'dockerized' (has a **working** ``Dockerfile``) +#. A service that incorporates a 'self-hosting' option #. A service written in a language you are familiar with #. A service with a strong community +You can check this expansive list if you are in search of ideas: `Awesome Self-Hosted `_ + What if I don't need a Config in my service? -------------------------------------------- Config files can be empty(``{}``), if you do not require config. diff --git a/source/index.rst b/source/index.rst index 76b25cf..5379689 100644 --- a/source/index.rst +++ b/source/index.rst @@ -6,10 +6,10 @@ Welcome to the Start9 Docs! Here you will find guidance and information about Embassy personal server and its operating system, EmbassyOS. If you identify an error with the docs or would like to contribute to them, please use the GitHub link at the top of this page. -EmbassyOS is designed to work out of the box with a minimal setup and immediate practicality. That being said, there are a great many different use-cases and utilities that can be added at your convenience. You can get started right away with :ref:`Initial Setup `. In the `User Manual `, you will find information on what EmbassyOS can do for you, as well as configuration and customization options. Use our `Knowledgebase ` to learn more about the technologies behind Embassy. When you're ready to build, please check out our `Developer Docs `. Please don't hestitate to `Contact Us `_ if you have any issues, questions, or suggestions that are not covered here. +EmbassyOS is designed to work out of the box with a minimal setup and immediate practicality. That being said, there are a great many different use-cases and utilities that can be added at your convenience. You can get started right away with :ref:`Initial Setup `. In the `User Manual `, you will find information on what EmbassyOS can do for you, as well as configuration and customization options. Use our `Knowledgebase ` to learn more about the technologies behind Embassy, including Frequently Asked Questions. When you're ready to build, please check out our `Developer Docs `. Please don't hestitate to `Contact Us `_ if you have any issues, questions, or suggestions that are not covered here. Table of Contents ------------------ +================= .. toctree:: :maxdepth: 1 diff --git a/source/user-manual/configuration/limitations/lim-android.rst b/source/user-manual/configuration/limitations/lim-android.rst index 918900b..15e9744 100644 --- a/source/user-manual/configuration/limitations/lim-android.rst +++ b/source/user-manual/configuration/limitations/lim-android.rst @@ -1,5 +1,13 @@ .. _lim-android: -******* -Android -******* +************************* +Android Known Limitations +************************* + +Local Access +============ +Android does not have native support for :ref:`mDNS` and therefore cannot resolve ``.local`` addresses. This issue has been long known and can be tracked `here `_ (Google account required to view). + +Workarounds +----------- +An app developer can add mDNS support, and some projects, such as Chromium, have long `considered it `_, but the real solution is for support to occur at the OS level. diff --git a/source/user-manual/configuration/limitations/lim-ios.rst b/source/user-manual/configuration/limitations/lim-ios.rst index 070c925..e8ce3f2 100644 --- a/source/user-manual/configuration/limitations/lim-ios.rst +++ b/source/user-manual/configuration/limitations/lim-ios.rst @@ -1,5 +1,21 @@ .. _lim-ios: -*** -iOS -*** +********************* +iOS Known Limitations +********************* + +Tor +=== +It is not currently possible to run Tor natively (in the background) on iOS. The best chance for this functionality coming to iOS is via the `iCepa Project `_. + +Workarounds +----------- +The only way to use Tor on iOS is with apps that come with Tor built-in, such as :ref:`Zap Wallet `. + +Matrix +====== +The lack of Tor support on iOS means that Element/Matrix cannot be run on an iPhone in conjunction with your Embassy Matrix server, as that currently requires a Tor connection. This will be fixed if `Element ` builds Tor into their app. + +Workarounds +----------- +None currently known. diff --git a/source/user-manual/configuration/limitations/lim-linux.rst b/source/user-manual/configuration/limitations/lim-linux.rst index 826f00e..8780d4e 100644 --- a/source/user-manual/configuration/limitations/lim-linux.rst +++ b/source/user-manual/configuration/limitations/lim-linux.rst @@ -1,5 +1,7 @@ .. _lim-linux: -***** -Linux -***** +*********************** +Linux Known Limitations +*********************** + +Linux has no known limitations in regard to Embassy. Congratulations, Master Race... diff --git a/source/user-manual/configuration/limitations/lim-mac.rst b/source/user-manual/configuration/limitations/lim-mac.rst index 86b2ded..58a7895 100644 --- a/source/user-manual/configuration/limitations/lim-mac.rst +++ b/source/user-manual/configuration/limitations/lim-mac.rst @@ -1,15 +1,6 @@ .. _lim-mac: -*** -Mac -*** +********************* +Mac Known Limitations +********************* -.. _lim-new-mac: - -Newer Mac (M1) -============== - -.. _lim-old-mac: - -Older Mac -========= \ No newline at end of file diff --git a/source/user-manual/configuration/limitations/lim-windows.rst b/source/user-manual/configuration/limitations/lim-windows.rst index d85658c..2e89be8 100644 --- a/source/user-manual/configuration/limitations/lim-windows.rst +++ b/source/user-manual/configuration/limitations/lim-windows.rst @@ -1,5 +1,5 @@ .. _lim-windows: -******* -Windows -******* +************************* +Windows Known Limitations +************************* diff --git a/source/user-manual/getting-started/device-guides/dg-android.rst b/source/user-manual/getting-started/device-guides/dg-android.rst index 6dd7b65..d8abfcd 100644 --- a/source/user-manual/getting-started/device-guides/dg-android.rst +++ b/source/user-manual/getting-started/device-guides/dg-android.rst @@ -3,3 +3,21 @@ ******* Android ******* + +Tor Setup (Connectivity) +======================== + +|location link| to run natively (in the background) on your device. This will allow you to use applications on your machine via the :ref:`Tor Network` so they can communicate with your Embassy. + +.. |location link| raw:: html + + Setup Tor + +Tor Firefox Config (Connectivity) +================================= + +|location link| to be able to use the :ref:`Tor Network` so that you can reach ``.onion`` sites without needing to change browsers. + +.. |location link| raw:: html + + Configure Firefox diff --git a/source/user-manual/getting-started/device-guides/dg-ios.rst b/source/user-manual/getting-started/device-guides/dg-ios.rst index fd9ffd2..d201d27 100644 --- a/source/user-manual/getting-started/device-guides/dg-ios.rst +++ b/source/user-manual/getting-started/device-guides/dg-ios.rst @@ -3,3 +3,12 @@ *** iOS *** + +LAN Setup (Connectivity, Performance) +===================================== + +|location link| for a fast and secure connection while on your Embassy's local network. + +.. |location link| raw:: html + + Setup LAN Access diff --git a/source/user-manual/getting-started/device-guides/dg-linux.rst b/source/user-manual/getting-started/device-guides/dg-linux.rst index 049630b..9aa0b4f 100644 --- a/source/user-manual/getting-started/device-guides/dg-linux.rst +++ b/source/user-manual/getting-started/device-guides/dg-linux.rst @@ -1,5 +1,32 @@ .. _dg-linux: -***** -Linux -***** +************ +Linux Guides +************ + +LAN Setup (Connectivity, Performance) +===================================== + +|location link| for a fast and secure connection while on your Embassy's local network. + +.. |location link| raw:: html + + Setup LAN Access + +Tor Setup (Connectivity) +======================== + +|location link| to run natively (in the background) on your device. This will allow you to use applications on your machine via the :ref:`Tor Network` so they can communicate with your Embassy. + +.. |location link| raw:: html + + Setup Tor + +Tor Firefox Config (Connectivity) +================================= + +|location link| to be able to use the :ref:`Tor Network` so that you can reach ``.onion`` sites without needing to change browsers. + +.. |location link| raw:: html + + Configure Firefox diff --git a/source/user-manual/getting-started/device-guides/dg-mac.rst b/source/user-manual/getting-started/device-guides/dg-mac.rst index f516748..b431a45 100644 --- a/source/user-manual/getting-started/device-guides/dg-mac.rst +++ b/source/user-manual/getting-started/device-guides/dg-mac.rst @@ -4,13 +4,29 @@ Mac *** -.. _dg-new-mac: +LAN Setup (Connectivity, Performance) +===================================== -Newer Mac (M1) -============== +|location link| for a fast and secure connection while on your Embassy's local network. -.. _dg-old-mac: +.. |location link| raw:: html -Older Mac -========= + Setup LAN Access +Tor Setup (Connectivity) +======================== + +|location link| to run natively (in the background) on your device. This will allow you to use applications on your machine via the :ref:`Tor Network` so they can communicate with your Embassy. + +.. |location link| raw:: html + + Setup Tor + +Tor Firefox Config (Connectivity) +================================= + +|location link| to be able to use the :ref:`Tor Network` so that you can reach ``.onion`` sites without needing to change browsers. + +.. |location link| raw:: html + + Configure Firefox diff --git a/source/user-manual/getting-started/device-guides/dg-windows.rst b/source/user-manual/getting-started/device-guides/dg-windows.rst index 7940d5b..d9f7d5e 100644 --- a/source/user-manual/getting-started/device-guides/dg-windows.rst +++ b/source/user-manual/getting-started/device-guides/dg-windows.rst @@ -3,3 +3,30 @@ ******* Windows ******* + +LAN Setup (Connectivity, Performance) +===================================== + +|location link| for a fast and secure connection while on your Embassy's local network. + +.. |location link| raw:: html + + Setup LAN Access + +Tor Setup (Connectivity) +======================== + +|location link| to run natively (in the background) on your device. This will allow you to use applications on your machine via the :ref:`Tor Network` so they can communicate with your Embassy. + +.. |location link| raw:: html + + Setup Tor + +Tor Firefox Config (Connectivity) +================================= + +|location link| to be able to use the :ref:`Tor Network` so that you can reach ``.onion`` sites without needing to change browsers. + +.. |location link| raw:: html + + Configure Firefox diff --git a/source/user-manual/getting-started/initial-setup.rst b/source/user-manual/getting-started/initial-setup.rst index fa737b0..de39ce6 100644 --- a/source/user-manual/getting-started/initial-setup.rst +++ b/source/user-manual/getting-started/initial-setup.rst @@ -50,7 +50,7 @@ Claim Your Embassy If your router does not support mDNS * On your desktop or laptop computer, navigate to your router configuration settings within the browser. This is usually an IP address such as 192.168.1.1. A simple Google search will usually reveal how to access the router configuration settings for a particular brand. - * Once in the router config settings, find the section that lists the devices on your network. You should see an item labeled "start9labs". Take note of the associated IP address and enter it into the Setup App in the "LAN IP Address" input field. + * Once in the router config settings, find the section that lists the devices on your network. You should see an item labeled "embassy". Take note of the associated IP address and enter it into your browser's URL field to enter setup. 3. Create your *permanent* master password and complete setup.