mirror of
https://github.com/Start9Labs/documentation.git
synced 2026-03-26 02:11:55 +00:00
Added sounds, latest podcast, YT links mobile responsive, misc edits
This commit is contained in:
@@ -5,7 +5,6 @@
|
||||
- Lightning Guides (Zeus)
|
||||
- Vaultwarden guide (screens)
|
||||
- Refactor and update Roadmap
|
||||
- BLOCKED: Possible sounds in troubleshooting (and link in overview / upgrade pages)
|
||||
|
||||
# AFTER PUBLISHING:
|
||||
- Add any new video content
|
||||
|
||||
BIN
site/source/_static/images/ssl/browser/brave-authorities.png
Normal file
BIN
site/source/_static/images/ssl/browser/brave-authorities.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 142 KiB |
BIN
site/source/_static/sounds/BEETHOVEN.mp3
Normal file
BIN
site/source/_static/sounds/BEETHOVEN.mp3
Normal file
Binary file not shown.
BIN
site/source/_static/sounds/BEP.mp3
Normal file
BIN
site/source/_static/sounds/BEP.mp3
Normal file
Binary file not shown.
BIN
site/source/_static/sounds/CHIME.mp3
Normal file
BIN
site/source/_static/sounds/CHIME.mp3
Normal file
Binary file not shown.
BIN
site/source/_static/sounds/SHUTDOWN.mp3
Normal file
BIN
site/source/_static/sounds/SHUTDOWN.mp3
Normal file
Binary file not shown.
@@ -11,6 +11,7 @@ Embassy
|
||||
Embassy is the plug 'n' play hardware device sold by Start9. The current iteration is a Raspberry Pi with an internal speaker in a custom, passively cooled case. The Embassy comes pre-loaded with EmbassyOS. Check out the video below to get a brief overview:
|
||||
|
||||
.. youtube:: GfMvXJxYamw
|
||||
:width: 100%
|
||||
|
||||
.. _embassy-os:
|
||||
|
||||
@@ -18,6 +19,48 @@ EmbassyOS
|
||||
---------
|
||||
EmbassyOS (EOS) is a Linux-based operating system custom built for self-hosting open source software. EOS has a range of features that allow anyone to run their own server software without needing all the traditionally required systems administration skills. Advanced dependency management, sensibly defaulted configuration with customization, and minimal reliance on the developers are just a few; all wrapped into a sleek GUI that anyone can operate. No command line required!
|
||||
|
||||
.. _sounds:
|
||||
|
||||
Embassy Sounds
|
||||
--------------
|
||||
EmbassyOS emits several sounds for user feedback and troubleshooting. Below are the current possible sounds and their meaning:
|
||||
|
||||
.. raw:: HTML
|
||||
|
||||
<audio controls>
|
||||
<source src="/_static/sounds/BEP.mp3" type="audio/mpeg">
|
||||
Your browser does not support the audio element.
|
||||
</audio>
|
||||
|
||||
* "bep" - Starting up
|
||||
|
||||
.. raw:: HTML
|
||||
|
||||
<audio controls>
|
||||
<source src="/_static/sounds/CHIME.mp3" type="audio/mpeg">
|
||||
Your browser does not support the audio element.
|
||||
</audio>
|
||||
|
||||
* "chime" - Embassy is ready
|
||||
|
||||
.. raw:: HTML
|
||||
|
||||
<audio controls>
|
||||
<source src="/_static/sounds/SHUTDOWN.mp3" type="audio/mpeg">
|
||||
Your browser does not support the audio element.
|
||||
</audio>
|
||||
|
||||
* "shutdown" - Embassy is shutting down
|
||||
|
||||
.. raw:: HTML
|
||||
|
||||
<audio controls>
|
||||
<source src="/_static/sounds/BEETHOVEN.mp3" type="audio/mpeg">
|
||||
Your browser does not support the audio element.
|
||||
</audio>
|
||||
|
||||
* "Beethoven" - An error has occurred - check your Notifications for more info, or :ref:`Contact Support<contact>`
|
||||
|
||||
.. _product-key:
|
||||
|
||||
EmbassyOS Product Key
|
||||
|
||||
@@ -12,6 +12,7 @@ The Internet is not so great atm...
|
||||
Self-Hosting
|
||||
------------
|
||||
|
||||
blah blah self-host ya shmuck. For an overview of this idea in relation to EmbassyOS, please check out the video below:
|
||||
For an overview of this idea in relation to EmbassyOS, please check out the video below:
|
||||
|
||||
.. youtube:: dc741XwqlyU
|
||||
:width: 100%
|
||||
|
||||
@@ -6,6 +6,14 @@ Podcasts
|
||||
|
||||
Podcasts featuring Start9 Labs and/or Embassy
|
||||
|
||||
.. topic-box::
|
||||
:title: February 24, 2022 - SLP352 Matt Hill
|
||||
:link: https://stephanlivera.com/episode/352/
|
||||
:image: https://i0.wp.com/stephanlivera.com/wp-content/uploads/2022/02/SLP352-WP-Thumbnail.png
|
||||
:anchor: Stephan Livera Podcast
|
||||
|
||||
EmbassyOS & Making Self-Sovereignty Tech Cheaper Than The Alternatives
|
||||
|
||||
.. topic-box::
|
||||
:title: January 25, 2022 - On The Record with Start9
|
||||
:link: https://www.youtube.com/watch?v=jMV_DWAMtmc
|
||||
|
||||
@@ -23,7 +23,7 @@ During initial setup, I am unable to connect to "embassy.local".
|
||||
|
||||
* Confirm that your Embassy is plugged into both power and Ethernet.
|
||||
|
||||
* Confirm the Embassy emitted two sounds when powering on: a bep and a chime.
|
||||
* Confirm the Embassy emitted two :ref:`sounds<sounds>` when powering on: a bep and a chime.
|
||||
|
||||
* Confirm your phone is **not** connected to a “Guest” network
|
||||
|
||||
|
||||
@@ -10,6 +10,7 @@ On first install, the Bitcoin service must verify the entire history of transact
|
||||
You can learn more about the Initial Block Download in `this video <https://www.youtube.com/watch?v=OrYDehC-8TU>`_.
|
||||
|
||||
.. youtube:: OrYDehC-8TU
|
||||
:width: 100%
|
||||
|
||||
Can the IBD (Initial Block Download) be made faster? Or can wait times be improved?
|
||||
------------------------------------------------------------------------------------
|
||||
@@ -56,7 +57,7 @@ Bitcoin Core is a full node that also contains wallet functionality. Some will
|
||||
You can use the wallet in Bitcoin Core, however it is for advanced users and is only available in the command line via SSH.
|
||||
|
||||
It is helpful to think of the Bitcoin Core service on the Embassy as your own personal Bitcoin Server. This is your own verified source of truth of the Bitcoin ledger, that requires no permission for you to set up and own. The job of your Bitcoin server is to verify that the transactions you want to make and receive are valid.
|
||||
There are modern wallets that have the ability to use your personal Bitcoin node as a source of truth, and with the advantages of additional security and advanced features. This also follows the Linux mantra of "do one thing and do it well." The recommended way to use Bitcoin with your Embassy’s Bitcoin node is with an external wallet.
|
||||
There are modern wallets that have the ability to use your personal Bitcoin node as a source of truth, and with the advantages of additional security and advanced features. This also follows the Linux mantra of "do one thing and do it well." The recommended way to use Bitcoin with your Embassy’s Bitcoin node is with an external wallet.
|
||||
The available wallets are listed in the following FAQ.
|
||||
|
||||
Which wallets can I use that sync with my Embassy Bitcoin and/or Lightning nodes?
|
||||
@@ -81,4 +82,4 @@ You would use your hardware signer with your wallet, then instruct that wallet t
|
||||
|
||||
- Signers are for generating and storing keys, as well as signing transactions.
|
||||
|
||||
The reason there is so much confusion about these 3 concepts is that the Bitcoin Core Node comes with its own Wallet (which you should not use), and that wallet is also a signer. In fact, most wallets double as signers, and most wallets do NOT support connecting to your own node. So, most wallets are actually serving as a wallet, a node, and a signer, which might be convenient, but it is neither trustless nor maximally secure. Ideally, you are using a wallet that supports both integrating with a hardware signer (like Coldcard or Trezor) AND a backend node (like on the Embassy).
|
||||
The reason there is so much confusion about these 3 concepts is that the Bitcoin Core Node comes with its own Wallet (which you should not use), and that wallet is also a signer. In fact, most wallets double as signers, and most wallets do NOT support connecting to your own node. So, most wallets are actually serving as a wallet, a node, and a signer, which might be convenient, but it is neither trustless nor maximally secure. Ideally, you are using a wallet that supports both integrating with a hardware signer (like Coldcard or Trezor) AND a backend node (like on the Embassy).
|
||||
|
||||
@@ -31,6 +31,7 @@ When you install Bitwarden on your Embassy, by contrast, it's like building your
|
||||
This `podcast <https://www.youtube.com/watch?v=aylDowaSdzU>`_ may help expound upon why this is important.
|
||||
|
||||
.. youtube:: aylDowaSdzU
|
||||
:width: 100%
|
||||
|
||||
How does Embassy work?
|
||||
----------------------
|
||||
@@ -57,7 +58,7 @@ EmbassyOS is a custom-built Linux distribution, which is a beefed up version of
|
||||
* Upgrade your Embassy software with the latest features and security updates
|
||||
* Backup services, and restore from backups if needed
|
||||
|
||||
It includes:
|
||||
It includes:
|
||||
|
||||
* a custom application management layer, specialized for installing, running, and backing up .s9pk packaged services
|
||||
* a layer responsible for Embassy specific operations, such as Tor, Backups, and Notifications
|
||||
@@ -121,4 +122,4 @@ I want to help, but I'm not a developer. Are there any ways for non-coders to c
|
||||
3. Make tutorial videos
|
||||
4. Write instruction manuals or commit to the docs
|
||||
|
||||
Check out the :ref:`Contribute<contribute>` section of this site for more details.
|
||||
Check out the :ref:`Contribute<contribute>` section of this site for more details.
|
||||
|
||||
@@ -13,6 +13,7 @@ How can I get started with Lightning and open my first channel?
|
||||
You can check out our `"Using Lightning" video <https://www.youtube.com/watch?v=rAvoUNsobws>`_ and learn the basics, including opening a channel with Start9.
|
||||
|
||||
.. youtube:: KhU_sTiaN8w
|
||||
:width: 100%
|
||||
|
||||
Please remember to always open a "Private" channel with us, or your channel is likely to be closed. Please don't hesitate to reach out to us with any questions.
|
||||
|
||||
|
||||
@@ -24,6 +24,12 @@ Trust Embassy CA in Brave
|
||||
:width: 60%
|
||||
:alt: Brave Security settings page
|
||||
|
||||
#. Click the "Authorities" tab
|
||||
|
||||
.. figure:: /_static/images/ssl/browser/brave-authorities.png
|
||||
:width: 60%
|
||||
:alt: Certificate Authorities
|
||||
|
||||
#. If you see "org-Start9" with a trusted “Embassy Local Root CA” listed under it, open a new tab to apply the certificate. If this does not work, quit and restart Brave.
|
||||
|
||||
#. If you do not see "org-Start9" in the list, click "Import" and open the downloaded "Embassy Local Root CA.crt" file on your device. Check the box for "Trust this certificate for identifying websites" and click "OK".
|
||||
|
||||
@@ -39,7 +39,7 @@ Once Tor is setup on your system, you can proceed to setup Firefox:
|
||||
:width: 50%
|
||||
:alt: Firefox socks remote dns setting screenshot
|
||||
|
||||
7. Search for ``dom.securecontext.whitelist_onions`` and set the value to ``true``.
|
||||
7. Search for ``dom.securecontext.allowlist_onions`` and set the value to ``true``. On some older versions, this may be called ``dom.securecontext.whitelist_onions``.
|
||||
|
||||
.. figure:: /_static/images/tor/firefox_whitelist_mobile.png
|
||||
:width: 50%
|
||||
|
||||
@@ -9,7 +9,7 @@ Configuring Firefox for Tor on Linux
|
||||
|
||||
#. Open Firefox and 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``.
|
||||
#. Search for ``dom.securecontext.allowlist_onions`` and set the value to ``true``. On some older versions, this may be called ``dom.securecontext.whitelist_onions``.
|
||||
|
||||
.. figure:: /_static/images/tor/firefox_whitelist.png
|
||||
:width: 60%
|
||||
|
||||
@@ -9,7 +9,7 @@ Configuring Firefox for Tor on Mac
|
||||
|
||||
#. Open Firefox and 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``.
|
||||
#. Search for ``dom.securecontext.allowlist_onions`` and set the value to ``true``. On some older versions, this may be called ``dom.securecontext.whitelist_onions``.
|
||||
|
||||
.. figure:: /_static/images/tor/firefox_whitelist.png
|
||||
:width: 60%
|
||||
|
||||
@@ -8,7 +8,7 @@ Configuring Firefox for Tor on Windows
|
||||
|
||||
#. Open Firefox and 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".
|
||||
#. Search for ``dom.securecontext.allowlist_onions`` and set the value to "true". On some older versions, this may be called ``dom.securecontext.whitelist_onions``.
|
||||
|
||||
.. figure:: /_static/images/tor/firefox_whitelist.png
|
||||
:width: 60%
|
||||
|
||||
@@ -7,6 +7,7 @@ Running Tor on Android
|
||||
Some apps, such as :ref:`Tor Browser<tor-browser>`, have Tor built in. They do not require additional software or configurations to utilize Tor. Most apps, however, do not have Tor built in. They require an app called Orbot to be installed in order to utilize the Tor Network.
|
||||
|
||||
.. youtube:: b__mVfN-BP8
|
||||
:width: 100%
|
||||
|
||||
Running Orbot
|
||||
-------------
|
||||
|
||||
@@ -7,6 +7,7 @@ Initial Setup
|
||||
Check out our quick setup video below, and follow along with the steps in this guide:
|
||||
|
||||
.. youtube:: DmTlwp5_zvY
|
||||
:width: 100%
|
||||
|
||||
Powering On
|
||||
-----------
|
||||
@@ -19,9 +20,24 @@ Powering On
|
||||
|
||||
#. You will hear 2 distinct sounds:
|
||||
|
||||
.. raw:: HTML
|
||||
|
||||
<audio controls>
|
||||
<source src="/_static/sounds/BEP.mp3" type="audio/mpeg">
|
||||
Your browser does not support the audio element.
|
||||
</audio>
|
||||
|
||||
* "bep" - Starting up
|
||||
|
||||
.. raw:: HTML
|
||||
|
||||
<audio controls>
|
||||
<source src="/_static/sounds/CHIME.mp3" type="audio/mpeg">
|
||||
Your browser does not support the audio element.
|
||||
</audio>
|
||||
|
||||
* "chime" - Embassy is ready
|
||||
|
||||
|
||||
.. caution:: If you followed the DIY guide and built EmbassyOS from source code, it may take up to 20 minutes to first initialize.
|
||||
|
||||
Claiming your Device
|
||||
|
||||
@@ -7,6 +7,7 @@ Lightning
|
||||
Check out our `Getting Started with Lightning video <https://www.youtube.com/watch?v=KhU_sTiaN8w>`_ for an introduction to the Lightning Network using LND and RTL on Embassy!
|
||||
|
||||
.. youtube:: KhU_sTiaN8w
|
||||
:width: 100%
|
||||
|
||||
.. _blue-wallet-lightning:
|
||||
|
||||
@@ -85,4 +86,4 @@ LND
|
||||
...
|
||||
|
||||
Spark
|
||||
.....
|
||||
.....
|
||||
|
||||
@@ -7,3 +7,4 @@ Matrix
|
||||
Check out our `Synapse video <https://www.youtube.com/watch?v=PtwQsybFapo>`_ for features and setup!
|
||||
|
||||
.. youtube:: PtwQsybFapo
|
||||
:width: 100%
|
||||
|
||||
@@ -9,7 +9,7 @@ Vaultwarden
|
||||
Check out our `Vaultwarden video <https://www.youtube.com/watch?v=YcxxVHpm9j0>`_ for basic features and setup!
|
||||
|
||||
.. youtube:: YcxxVHpm9j0
|
||||
|
||||
:width: 100%
|
||||
|
||||
Web Vault
|
||||
---------
|
||||
@@ -89,12 +89,12 @@ Mac
|
||||
|
||||
#. LAN
|
||||
#. First, be sure to :ref:`Setup LAN <lan-mac>` natively.
|
||||
|
||||
|
||||
#. For LAN access, follow the LAN setup in the instructions below. After completing setup, simply open Bitwarden and add your LAN address in the 'Settings' and login.
|
||||
|
||||
#. Tor
|
||||
#. First, be sure to :ref:`Setup Tor <tor-mac>` natively.
|
||||
|
||||
|
||||
#. Run the program with the flag ` --proxy-server=socks5://127.0.0.1:9050` behind it. You can run this from a terminal, and if you'd like to use a shortcut, edit that shortcut file to include the flag.
|
||||
|
||||
#. You can now log in to your vault.
|
||||
|
||||
@@ -33,6 +33,7 @@ Backing up
|
||||
If you're unsure how to do this - please follow `this <https://youtube.com/watch?v=_QJXgnE90ko>`_ guide.
|
||||
|
||||
.. youtube:: _QJXgnE90ko
|
||||
:width: 100%
|
||||
|
||||
With your Embassy safely backed up, it's time to proceed with the migration.
|
||||
|
||||
|
||||
Submodule sphinx-scylladb-theme updated: 8558b5f770...3e0c910002
Reference in New Issue
Block a user