diff --git a/README.md b/README.md index e64ef96..8d53fc4 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -# Start9 Labs Documentation +# Start9 Documentation At Start9, we see great value in maintaining clear and accurate documentation for our already simple and friendly products. These docs are a continuous work-in-progress, and we welcome contributions from our partners and customers. @@ -18,6 +18,7 @@ Install sphinx and dependencies: brew install sphinx-doc pip3 install sphinx-autobuild pip3 install sphinx-book-theme || pip install git+https://github.com/executablebooks/sphinx-book-theme.git@master +pip3 install sphinxcontrib.yt ``` ### Development diff --git a/source/_static/logo.png b/source/_static/logo.png index d693f72..63e10bd 100644 Binary files a/source/_static/logo.png and b/source/_static/logo.png differ diff --git a/source/conf.py b/source/conf.py index 7886234..85ae9e5 100644 --- a/source/conf.py +++ b/source/conf.py @@ -14,10 +14,9 @@ # import sys # sys.path.insert(0, os.path.abspath('.')) - # -- Project information ----------------------------------------------------- -project = 'Start9 Labs' +project = 'Start9 Docs' copyright = '2021, Start9 Labs, Inc' # -- General configuration --------------------------------------------------- @@ -26,6 +25,7 @@ copyright = '2021, Start9 Labs, Inc' # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom # ones. extensions = [ + 'sphinxcontrib.yt' # 'sphinxcontrib.needs' ] diff --git a/source/getting-started/introduction.rst b/source/getting-started/introduction.rst index 5b8eb92..112e1b2 100644 --- a/source/getting-started/introduction.rst +++ b/source/getting-started/introduction.rst @@ -4,10 +4,10 @@ Introduction Embassy is a new kind of personal computer - one that sits quietly on your shelf and runs all day and night. It has no screen and no keyboard. You access your Embassy from anywhere in the world in total, trustless privacy, simply by visiting its unique Tor address (.onion URL) right from the browser. -Embassy is composed of commonly available hardware components that can be sourced and assembled by anyone, anywhere, for a marginal fee. Embassy is powered by EmbassyOS, the open-source operating system by Start9 Labs. +Embassy is composed of commonly available hardware components that can be sourced and assembled by anyone, anywhere, for a marginal fee. Embassy is powered by EmbassyOS, the open-source operating system by Start9. So, what do you do with your Embassy? You use it to run services: Bitcoin, Lightning, personal cloud storage, P2P messaging, password management, etc. The list of available services is growing quickly and will eventually encompass the entirety of open-source, self-hosted software. Every communication between you and your Embassy is end-to-end encrypted and onion routed over the Tor network. All services are open-source and self-hosted, meaning there are no trusted third parties of any kind. -To get an Embassy, you can :ref:`purchase` one directly from Start9 Labs, or you can :ref:`build one yourself`. \ No newline at end of file +To get an Embassy, you can :ref:`purchase` one directly from Start9, or you can :ref:`build one yourself`. \ No newline at end of file diff --git a/source/getting-started/purchasing.rst b/source/getting-started/purchasing.rst index a2be5ce..0a2fc43 100644 --- a/source/getting-started/purchasing.rst +++ b/source/getting-started/purchasing.rst @@ -4,6 +4,6 @@ Purchasing ********** -For maximum convenience, you can purchase an Embassy device directly from Start9 Labs through our `Shopify Store `_. The device comes in a beautiful box, fully-assembled, and pre-installed with the latest version of EmbassyOS. We do our own hardware assembly and fulfillment, and we only collect the minimal information necessary to fulfill your order. And yes, we accept Bitcoin. +For maximum convenience, you can purchase an Embassy device directly from Start9 through our `Shopify Store `_. The device comes in a beautiful box, fully-assembled, and pre-installed with the latest version of EmbassyOS. We do our own hardware assembly and fulfillment, and we only collect the minimal information necessary to fulfill your order. And yes, we accept Bitcoin. If you prefer to build your own Embassy, you can follow the :ref:`DIY Guide `. \ No newline at end of file diff --git a/source/index.rst b/source/index.rst index ddf0e9c..bccec33 100644 --- a/source/index.rst +++ b/source/index.rst @@ -1,6 +1,6 @@ -######################### -Start9 Labs Documentation -######################### +#################### +Start9 Documentation +#################### Welcome to the docs! diff --git a/source/misc-guides/tor-firefox/desktop.rst b/source/misc-guides/tor-firefox/desktop.rst index 81312e7..87e5175 100644 --- a/source/misc-guides/tor-firefox/desktop.rst +++ b/source/misc-guides/tor-firefox/desktop.rst @@ -21,7 +21,7 @@ Setting up Firefox with Tor on Desktop Windows: -Click `here `_ to get the file and save the file somewhere you won’t delete it. For this example: +Click `here `_ 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:: diff --git a/source/misc-guides/tor-firefox/ios.rst b/source/misc-guides/tor-firefox/ios.rst index ad0a5b8..141befb 100644 --- a/source/misc-guides/tor-firefox/ios.rst +++ b/source/misc-guides/tor-firefox/ios.rst @@ -6,4 +6,4 @@ 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: -You can use Start9 Labs' own Consulate Browser, which is available `here `_, or you can select another Tor Browser by searching the `App Store `_. +You can use Start9's own Consulate Browser, which is available `here `_, or you can select another Tor Browser by searching the `App Store `_. diff --git a/source/misc-guides/tor-os/android.rst b/source/misc-guides/tor-os/android.rst index 422326a..24f45c1 100644 --- a/source/misc-guides/tor-os/android.rst +++ b/source/misc-guides/tor-os/android.rst @@ -6,6 +6,8 @@ Running Tor on Android Some apps, such as Tor Browser or Cups Messenger, 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 Tor. +.. youtube:: b__mVfN-BP8 + Running Orbot ------------- diff --git a/source/misc-guides/tor-os/ios.rst b/source/misc-guides/tor-os/ios.rst index 847cbc0..73ee67e 100644 --- a/source/misc-guides/tor-os/ios.rst +++ b/source/misc-guides/tor-os/ios.rst @@ -6,4 +6,4 @@ Setting up Tor on iOS Unfortunately, Apple does not allow tor to be run natively on iOS. This leaves 2 options for iOS users: -You can use Start9 Labs' own Consulate Browser, which is available `here `_, or you can select another Tor Browser by searching the `App Store `_. +You can use Start9's own Consulate Browser, which is available `here `_, or you can select another Tor Browser by searching the `App Store `_. diff --git a/source/support/FAQ/bitcoin-faq.rst b/source/support/FAQ/bitcoin-faq.rst index 3659de3..a1c958d 100644 --- a/source/support/FAQ/bitcoin-faq.rst +++ b/source/support/FAQ/bitcoin-faq.rst @@ -9,20 +9,16 @@ You can learn more about the Initial Block Download in `this video `_ and select the tutorial based on your operating system. + +More guides, particularly in video form, are forthcoming. + +Is BlueWallet an option? +------------------------ +BlueWallet requires a separate backend service called LNDHub, which is not available on the Embassy at this time. + +I want to use my hardware signer, such as Coldcard or Trezor, with my Embassy. How does this work? +--------------------------------------------------------------------------------------------------- +You do not use hardware signers directly with your node. Hardware signers interface with wallets, and wallets interface with nodes. + +Node (Embassy) <— Wallet (Specter, Sparrow, Electrum) <— Hardware signer (Coldcard, Trezor) + +You would use your hardware signer with your wallet, then instruct that wallet to use Embassy as its node. + +- Nodes are for interacting with the Bitcoin network: enforcing consensus rules, validating and relaying blocks/transactions, and broadcasting transactions. + +- Wallets are for constructing and viewing transactions, as well as generating addresses. + +- 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). + +Please note: of the wallets listed (Specter/Sparrow/Electrum), only Specter is currently able to use Embassy as it's node, but the other two should be available soon. + + Why would I want to run a lightning node? ----------------------------------------- The Lightning Network (LN) is a second 'layer,' built on top of the Bitcoin Protocol. As a result all transactions on LN are backed up by the full security of the Bitcoin network. Lightning is designed for instant payments between nodes, but similar to running a Bitcoin node, running your own is the only way to be sovereign. When you have your own node, you will have the convenience of linking a Lightning wallet, for use on the go. It is also possible to earn an income (granted a very small one at this time), if you are willing to learn how to become a 'routing node.' @@ -53,55 +112,6 @@ Is there a solution to this? ---------------------------- Yes, the concept of a Watchtower was originally conceptualized in the LN whitepaper. A Watchtower is simply a lightning node to which you can give the authority to monitor transactions associated with your open payment channels. -Is a wallet vulnerable to hacking if it’s always online?? ---------------------------------------------------------- -Funds are not stored on the node typically. The node simply serves as a source of truth for the state of the blockchain. Attacks depend on where the keys are and where the signing happens. You can use something like a hardware wallet for better security. Though, to be fair, a lot of attacks depend on you or your machine being targeted specifically, and a whole bunch of attack vectors are highly theoretical and obscure. -Most successful attacks seem to be either fake/doctored software or a social attack (tricking you into installing some malware or giving your seed outright or something like that). -Keep in mind, however, the more value there is out there to steal, the more sophisticated attacks will get automated (bots, crawlers etc). So its not just the risk profile of today, but also tomorrow you have to consider. That’s why something like a hardware wallet or dedicated mobile device for key signing is a good idea. -Even if your wallet is plugged into your Embassy, whether your wallet is hot or cold depends on the hardware that stores the keys. - -How does Bitcoin Proxy request (and verify) data when that data is needed by some app using it? ------------------------------------------------------------------------------------------------ -Proxy fetches blocks from your pruned node if it still has them, and fetches them from peers when it does not. Proxy can ensures the fetched block is valid by comparing it to its header, which is retained by the pruned node. The header is a product of the hash of the block itself, amongst other things, so it can't be - -What is the difference between the Bitcoin Wallet Tracker and the Electrum Personal Server? -------------------------------------------------------------------------------------------- -Bitcoin Wallet Tracker and Electrum Personal Server are 2 services that do the same thing, similar to bitcoind vs btcd, or lnd vs c-lightning. -Both work with your Bitcoin node to provide a richer set of information to wallets than could be done with bitcoind alone. They are basically identical in purpose, their differences are notably in the software memory requirements and how snappily they can answer the same questions. -Electrum (and some other wallets) require more than just a Bitcoin node to run in a sovereign way, they require an “Electrum Server”. Both Electrum Personal Server and Bitcoin Wallet Tracker are “Electrum servers”. - -I want to use my hardware signer, such as Coldcard or Trezor, with my Embassy. How does this work? ---------------------------------------------------------------------------------------------------- -You do not use hardware signers directly with your node. Hardware signers interface with wallets, and wallets interface with nodes. - -Node (Embassy) <— Wallet (Specter, Sparrow, Electrum) <— Hardware signer (Coldcard, Trezor) - -You would use your hardware signer with your wallet, then instruct that wallet to use Embassy as its node. - -- Nodes are for interacting with the Bitcoin network: enforcing consensus rules, validating and relaying blocks/transactions, and broadcasting transactions. - -- Wallets are for constructing and viewing transactions, as well as generating addresses. - -- 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). - -Please note: of the wallets listed (Specter/Sparrow/Electrum), only Specter is currently able to use Embassy as it's node, but the other two should be available soon. - -Which wallets can I use that sync with my Embassy Bitcoin node? ---------------------------------------------------------------- -There are many wallets that support linking to your own full node. You will need one that supports Tor. Here are a few options that are compatible: FullyNoded, Samourai, Specter, Wasabi, Zap, and Zeus. - -Is there a guide for connecting Specter Wallet to my Embassy? -------------------------------------------------------------- -There is. Please follow the integration guide `here `_ and select the tutorial based on your operating system. - -More guides, particularly in video form, are forthcoming. - -Is BlueWallet an option? ------------------------- -BlueWallet requires a separate backend service called LNDHub, which is not available on the Embassy at this time. - Is it possible to run c-lightning and lnd parallel on the Embassy? ------------------------------------------------------------------ Yes, you may run both. They will operate in their own environments and allow you to run services that depend on either. diff --git a/source/support/FAQ/general-faq.rst b/source/support/FAQ/general-faq.rst index 3ecce31..57a509a 100644 --- a/source/support/FAQ/general-faq.rst +++ b/source/support/FAQ/general-faq.rst @@ -51,12 +51,12 @@ EmbassyOS is a custom-built Linux distribution, which is a stripped down and bee * Upgrade your Embassy software with the latest features and security updates * Backup services, and restore from backups if needed -Start9 Labs augmented the original Raspbian OS to include: +Start9 augmented the original Raspbian OS to include: * 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 -The .s9pk extension is Start9 Labs' custom package format based on tar. It encompasses the necessary components to compress, host, and install a service on the marketplace. +The .s9pk extension is Start9's custom package format based on tar. It encompasses the necessary components to compress, host, and install a service on the marketplace. What are EmbassyOS Services? ---------------------------- @@ -76,7 +76,7 @@ Yes. Is the software Open Source? ---------------------------- -Yes! EmbassyOS is open sourced under the `Start9 Personal Use License `_. Some of our other projects are currently open sourced under MIT. You can find these in the Start9 Labs `GitHub repository `_. +Yes! EmbassyOS is open sourced under the `Start9 Personal Use License `_. Some of our other projects are currently open sourced under MIT. You can find these in the Start9 `GitHub repository `_. Is there a product warranty? ---------------------------- diff --git a/source/support/FAQ/services-faq.rst b/source/support/FAQ/services-faq.rst index 2c27134..ae0c120 100644 --- a/source/support/FAQ/services-faq.rst +++ b/source/support/FAQ/services-faq.rst @@ -51,9 +51,9 @@ Can I use my CUPS instance with other people? How does that work? ----------------------------------------------------------------- Cups does not have multiple accounts support. Each person would need their own Embassy. We are considering adding multi-account support to Cups, but it's just not a priority at the moment. -Is the embassy able to connect to Sphinxchat? ---------------------------------------------- -We have added Sphinx as an Embassy service. Please see the announcement `here `_ and check the Marketplace to start using Sphinx! +How can I fix issues with Sphinx? +--------------------------------- +If you are on Android, make sure Orbot is setup correctly, and if it is, try to restart it or your device. If you still have issues, *back up your keys,* delete all app data from your phone, uninstall, restart the Sphinx service on your Embassy, then reinstall and import your keys. I get an error ("Unlock Wallet Failed") when trying to log in to RTL, what can I do? ------------------------------------------------------------------------------------ @@ -65,7 +65,7 @@ You can only follow someone who has an account on a Mastodon server that support Can the browser extension be used with Bitwarden hosted on the embassy? ----------------------------------------------------------------------- -Yes, but only in a tor-enabled browser. Just add your .onion address as the server in the extension. +Yes, but only in a tor-enabled browser. Just add your .onion address as the server in the extension. Make sure that http:// is at the beginning, and NOT https://, as this will not work. I want to use BTCPayServer on my website, but Tor is the only option, how can visitors access my BTCPay on clearnet? -------------------------------------------------------------------------------------------------------------------- diff --git a/source/support/FAQ/usage-faq.rst b/source/support/FAQ/usage-faq.rst index 619c4d2..5a4ac76 100644 --- a/source/support/FAQ/usage-faq.rst +++ b/source/support/FAQ/usage-faq.rst @@ -36,7 +36,7 @@ Unfortunately, no. Google has not included support for .local addresses via mDN Is the software Open Source? ---------------------------- -Yes! EmbassyOS is open sourced under the `Start9 Personal Use License `_. Some of our other projects are currently open sourced under MIT. You can find these in the Start9 Labs `GitHub repository `_. +Yes! EmbassyOS is open sourced under the `Start9 Personal Use License `_. Some of our other projects are currently open sourced under MIT. You can find these in the Start9 `GitHub repository `_. Is there a product warranty? ---------------------------- diff --git a/source/user-manual/general/developer-options/alt-marketplace.rst b/source/user-manual/general/developer-options/alt-marketplace.rst index cea595a..c17825d 100644 --- a/source/user-manual/general/developer-options/alt-marketplace.rst +++ b/source/user-manual/general/developer-options/alt-marketplace.rst @@ -2,7 +2,7 @@ Alternative Marketplace *********************** -EmbassyOS supports accessing alternative marketplaces by configuring a system file. Start9 Labs is not responsible for issues encountered by downloading services from alternative marketplaces. +EmbassyOS supports accessing alternative marketplaces by configuring a system file. Start9 is not responsible for issues encountered by downloading services from alternative marketplaces. After SSH-ing into the Embassy, run the following commands:: diff --git a/source/user-manual/initial-setup.rst b/source/user-manual/initial-setup.rst index e4d4c4d..b2a9ae7 100644 --- a/source/user-manual/initial-setup.rst +++ b/source/user-manual/initial-setup.rst @@ -4,8 +4,7 @@ Initial Setup ************* -.. .. raw:: html -.. +.. youtube:: DmTlwp5_zvY Download the Setup App ======================