From cdb97501d62c019168db4b09693b92f892dcdce3 Mon Sep 17 00:00:00 2001 From: kn0wmad <39687477+kn0wmad@users.noreply.github.com> Date: Mon, 16 Jan 2023 13:57:43 -0700 Subject: [PATCH] Add notes on VPNs (#273) --- site/source/support/common-issues.rst | 2 +- site/source/support/faq/faq-basic-use.rst | 9 ++++++++- site/source/support/faq/faq-troubleshooting.rst | 2 +- site/source/user-manual/initial-setup.rst | 6 +++++- 4 files changed, 15 insertions(+), 4 deletions(-) diff --git a/site/source/support/common-issues.rst b/site/source/support/common-issues.rst index d71827f..42075c1 100644 --- a/site/source/support/common-issues.rst +++ b/site/source/support/common-issues.rst @@ -38,7 +38,7 @@ If you still cannot connect, try logging into your router (the directions for wh I am unable to reach Embassy via it's embassy-xxxxxxxx.local (LAN) address ------------------------------------------------------------------------------ -Make sure you have successfully followed the :ref:`LAN Setup` instructions for your device. If you still cannot connect, try all the solutions listed under :ref:`initial setup `. +Make sure you have successfully followed the :ref:`LAN Setup` instructions for your device. If you are using Windows, your problem is almost certainly with Bonjour - follow the directions to reinstall, even if you have already done so. If you still cannot connect, try all the solutions listed under :ref:`initial setup `. I am unable to reach Embassy via it's xxxxxxxxxxxxxxxxxx.onion (Tor) address -------------------------------------------------------------------------------- diff --git a/site/source/support/faq/faq-basic-use.rst b/site/source/support/faq/faq-basic-use.rst index 244fee8..baf8834 100644 --- a/site/source/support/faq/faq-basic-use.rst +++ b/site/source/support/faq/faq-basic-use.rst @@ -21,6 +21,13 @@ Can I run multiple Embassies? ----------------------------- Yes, but there is currently no way to synchronize or federate them. We are working on ways to make this possible in the future. +Can I still use my VPN? +----------------------- +The short answer is yes, but they can cause some conflicts when accessing your Embassy. If you need to troubleshoot, turning off your VPN is a good place to start. The following VPNs are known to not interfere with the proper settings: + +- Mullvad - Go to "Settings -> VPN Settings -> Local Network Sharing" - enable this option to be able to access your Embassy's ``.local`` addresses. +- ProtonVPN - Go to "Preferences -> Connection -> Allow LAN Connections" - enable this option to be able to access your Embassy's ``.local`` addresses. + What if I forget my Embassy password? ------------------------------------- Please follow the :ref:`password reset guide`. @@ -85,4 +92,4 @@ The fastest way to get support is via our :ref:`Community channels`. P I bought an Embassy before Q3 2022 and it came with a 'product key,' what is that? ---------------------------------------------------------------------------------- -This will entitle you to white glove support as well as future benefits yet to be announced. Newer products ship with a similar (anonymous) key for these purposes. \ No newline at end of file +This will entitle you to white glove support as well as future benefits yet to be announced. Newer products ship with a similar (anonymous) key for these purposes. diff --git a/site/source/support/faq/faq-troubleshooting.rst b/site/source/support/faq/faq-troubleshooting.rst index e8d2d29..cd316a2 100644 --- a/site/source/support/faq/faq-troubleshooting.rst +++ b/site/source/support/faq/faq-troubleshooting.rst @@ -31,7 +31,7 @@ I cannot reach embassy.local after hearing the start-up sounds from Embassy. Wh * Ensure that you are on the same network as your Embassy. Check that it is not a "Guest" network in your router * Your browser might try to force https://embassy.local, delete the https:// prefix and try again with just embassy.local or http://embassy.local * Try a different browser, and note that Tor Browser cannot handle .local addresses -* Turn off your VPN if you are using one (you may turn it back on after setup) +* Turn off your VPN if you are using one (you may turn it back on after setup), or "allow LAN connections" if your VPN has such a setting. * If none of the above work, check your network setup, including your router settings if they are non-standard .. _why-bonjour: diff --git a/site/source/user-manual/initial-setup.rst b/site/source/user-manual/initial-setup.rst index d975773..b9bdb78 100644 --- a/site/source/user-manual/initial-setup.rst +++ b/site/source/user-manual/initial-setup.rst @@ -128,7 +128,11 @@ If you are experiencing issues with setup, try the following: #. Confirm the Embassy emitted two sounds when powering on: :ref:`a bep and a chime` #. Confirm your phone/computer is **not** connected to a "Guest" network -#. Confirm your phone/computer is not using a VPN +#. Confirm your phone/computer is not using a VPN, or that if you are, it allows LAN connections, such as the options below: + + - Mullvad - Go to "Settings -> VPN Settings -> Local Network Sharing" + - ProtonVPN - Go to "Preferences -> Connection -> Allow LAN Connections" + #. Visit or Refresh the embassy.local page in a web browser #. To avoid networking issues, it is recommended to use your `primary` router, not an extender or mesh router. #. Very rarely, your firewall settings may block mDNS. In this case: