mirror of
https://github.com/Start9Labs/documentation.git
synced 2026-03-30 12:11:57 +00:00
change embassyOS to StartOS & nuance (#357)
* change embassyOS to StartOS & nuance * Update conf.py * Update manifest.rst * say start9 instead of embassy in two links * progress * scrubbed faqs - basic-use, lightning, service-packaging, services, startos * add a few fixes * more * more 'embassy' cleanup * more * the last of embassy (aside from sdk and cli commands, links, etc) * some fixes * update icon, logo, and theme * Update site/source/user-manual/upgrade-hardware/upgrade-pro.rst * Update site/source/developer-docs/packaging.rst * Update site/source/developer-docs/specification/config-spec.rst * Update site/source/learn/concepts/networks.rst * Update site/source/learn/concepts/networks.rst * Update site/source/user-manual/customize.rst * Update site/source/support/faq/faq-basic-use.rst * Update site/source/user-manual/upgrade-hardware/naspi-upgrade.rst * Update site/source/user-manual/upgrade-hardware/upgrade-pro.rst * Update site/source/support/faq/faq-bitcoin.rst * Update site/source/support/faq/faq-bitcoin.rst * Update site/source/support/faq/faq-general.rst * Update site/source/support/faq/faq-general.rst * Update site/source/support/faq/faq-general.rst * Update site/source/support/faq/faq-general.rst * Update site/source/support/faq/faq-services.rst * Update site/source/support/faq/faq-general.rst * Update site/source/support/faq/faq-startos.rst * Update site/source/support/faq/faq-troubleshooting.rst * Update site/source/support/faq/faq-startos.rst * Minor fixes * Fix build errors, ready to roll * Add Beethoven * More fixes * More nother fix * More nother fixes agin * Remove sentence * cards instead --------- Co-authored-by: Matt Hill <matthewonthemoon@gmail.com> Co-authored-by: Shadowy Super Coder <musashidisciple@proton.me> Co-authored-by: Lucy Cifferello <12953208+elvece@users.noreply.github.com> Co-authored-by: kn0wmad <39687477+kn0wmad@users.noreply.github.com> Co-authored-by: agent <kn0wmad@protonmail.com>
This commit is contained in:
@@ -12,24 +12,24 @@ What do I do first?
|
||||
-------------------
|
||||
Please check out the :ref:`Initial Setup <initial-setup>` page, and follow the instructions.
|
||||
|
||||
How do I know if my Embassy is running?
|
||||
---------------------------------------
|
||||
How do I know if my server is running?
|
||||
--------------------------------------
|
||||
After plugging into power and your router, you will hear 2 distinct sounds: first, a “bep” ‐ indicating the device is powering on, and second, a “chime” ‐ indicating the device is ready for setup. You can hear these sounds on the :ref:`Initial Setup<initial-setup>` page.
|
||||
|
||||
My Embassy is really hot! Is this normal?
|
||||
------------------------------------------
|
||||
My server is really hot! Is this normal?
|
||||
-----------------------------------------
|
||||
On early devices, yes. These cases are actually doing 'double duty' as a heat sync. This means that the metal of the case is actually touching the chips on the circuit board and drawing their heat out and away. This is known as "passive cooling," as no fan (and therefore no noise) is required to cool the system.
|
||||
|
||||
You can check the chip temperature of your device under "System -> Metrics".
|
||||
|
||||
I'm trying to migrate my old Embassy data, but the device won't boot. What do I do?
|
||||
------------------------------------------------------------------------------------
|
||||
I'm trying to migrate my old server data, but the device won't boot. What do I do?
|
||||
-----------------------------------------------------------------------------------
|
||||
Remove the external drive and sd card adapter if they are plugged in. Boot the device with just the new (32GB) sd card inserted. After you hear the start-up sounds, you may plug in the external drive and old (128GB) sd card.
|
||||
|
||||
I cannot reach embassy.local after hearing the start-up sounds from Embassy. What do I do?
|
||||
-------------------------------------------------------------------------------------------
|
||||
* 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
|
||||
I cannot reach start.local after hearing the start-up sounds. What do I do?
|
||||
----------------------------------------------------------------------------
|
||||
* Ensure that you are on the same network as your server. Check that it is not a "Guest" network in your router
|
||||
* Your browser might try to force https://start.local, delete the https:// prefix and try again with just start.local or http://start.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), 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
|
||||
@@ -38,7 +38,7 @@ I cannot reach embassy.local after hearing the start-up sounds from Embassy. Wh
|
||||
|
||||
Why do I need the Bonjour service (Windows)?
|
||||
--------------------------------------------
|
||||
A major use-case of Bonjour is wireless printing over the LAN, but your Windows machine can also use Bonjour to discover and connect with other devices on the :ref:`Local Network<lan>`. In this case your Embassy. If Windows were to add support for reaching ``.local`` addresses, as is done in Linux and Mac, this would no longer be necessary.
|
||||
A major use-case of Bonjour is wireless printing over the LAN, but your Windows machine can also use Bonjour to discover and connect with other devices on the :ref:`Local Network<lan>`. In this case your Start9 server. If Windows were to add support for reaching ``.local`` addresses, as is done in Linux and Mac, this would no longer be necessary.
|
||||
|
||||
Recent updates to Windows may obviate the need for Bonjour, but so far results are mixed.
|
||||
|
||||
@@ -48,24 +48,20 @@ This is most likely a transient networking issue that will correct itself in a f
|
||||
|
||||
1. On Android/Orbot, the most common solution is to restart your Android device.
|
||||
|
||||
2. Access your Embassy over :ref:`LAN <connecting-lan>`, and restart it from the "Embassy" menu. (Restart by removing power if you cannot access via LAN)
|
||||
2. Access your server over :ref:`LAN <connecting-lan>`, and restart it from the "System" menu. (Restart by removing power if you cannot access via LAN)
|
||||
|
||||
3. Restart your router.
|
||||
|
||||
Do I need to take any additional security precautions with my device, for example with my router/modem?
|
||||
-------------------------------------------------------------------------------------------------------
|
||||
Nothing special is required, however, it is best practice to use good passwords, i.e. for your WiFi and your Embassy. Here's a `comic <https://xkcd.com/936/>`_ explaining how to make strong passwords, simply.
|
||||
Nothing special is required, however, it is best practice to use good passwords, i.e. for your WiFi and your server. Here's a `comic <https://xkcd.com/936/>`_ explaining how to make strong passwords, simply.
|
||||
|
||||
What if I have an unique network issue, for example, with a firewall?
|
||||
---------------------------------------------------------------------
|
||||
Embassy is designed to work as simply as possible, for as many as possible, while providing the ability to host in a private manner. If you have an agressive or custom firewall, or other custom network settings, there is a good chance that addtional configuration may be necessary. We will continue to learn about custom networking issues, update our docs with resources, and help in the :ref:`Community Channels <contact>` to the best of our ability.
|
||||
StartOS is designed to work as simply as possible, for as many as possible, while providing the ability to host in a private manner. If you have an aggressive or custom firewall, or other custom network settings, there is a good chance that addtional configuration may be necessary. We will continue to learn about custom networking issues, update our docs with resources, and help in the :ref:`Community Channels <contact>` to the best of our ability.
|
||||
|
||||
Can I use my Embassy from behind a VPN, for example, if my router has a built-in VPN?
|
||||
-------------------------------------------------------------------------------------
|
||||
Can I use my server from behind a VPN, for example, if my router has a built-in VPN?
|
||||
------------------------------------------------------------------------------------
|
||||
Yes, this is possible, but it adds complexity, which may lead to problems. You will need to understand the setup of your router/VPN and how it supports (or doesn't support) Tor/LAN connections.
|
||||
|
||||
If you are having trouble with this, you might consider letting Embassy out "in the clear," since all services are accessible over the Tor network, offering a high level of privacy. Obviously, Start9 cannot support every variation of router and network.
|
||||
|
||||
Is it true that my device has some limited functionality in regard to Embassy?
|
||||
------------------------------------------------------------------------------
|
||||
The short answer is probably not, and there are often workarounds for the few known limitations. Please see the :ref:`Limitations<limitations>` page for details on your device.
|
||||
If you are having trouble with this, you might consider letting your server out "in the clear," since all services are accessible over the Tor network, offering a high level of privacy. Obviously, Start9 cannot support every variation of router and network.
|
||||
|
||||
Reference in New Issue
Block a user