From af2b71d0dcf84d9b945b489b96195f8215752be7 Mon Sep 17 00:00:00 2001 From: kn0wmad <39687477+kn0wmad@users.noreply.github.com> Date: Tue, 11 Jul 2023 15:38:20 +0000 Subject: [PATCH] Hardware Upgrade Section Refactor and General Maintenance (#430) * Link fixes, FAQ maintenance, minor copy fixes * Remove device limitations (yay), several build and link fixes, refactor hardware upgrades, add generalized SSD migrations * Update drive-upgrade.rst * Update site/source/support/faq/faq-basic-use.rst Co-authored-by: gStart9 <106188942+gStart9@users.noreply.github.com> * Update site/source/support/faq/faq-bitcoin.rst Co-authored-by: gStart9 <106188942+gStart9@users.noreply.github.com> * Update site/source/support/faq/faq-bitcoin.rst Co-authored-by: gStart9 <106188942+gStart9@users.noreply.github.com> * Update site/source/support/faq/faq-bitcoin.rst Co-authored-by: gStart9 <106188942+gStart9@users.noreply.github.com> * Update site/source/support/faq/faq-general.rst Co-authored-by: gStart9 <106188942+gStart9@users.noreply.github.com> * Update site/source/support/faq/faq-general.rst Co-authored-by: gStart9 <106188942+gStart9@users.noreply.github.com> * Update site/source/support/faq/faq-lightning.rst Co-authored-by: gStart9 <106188942+gStart9@users.noreply.github.com> * Update site/source/support/faq/faq-lightning.rst Co-authored-by: gStart9 <106188942+gStart9@users.noreply.github.com> * Update site/source/support/faq/faq-services.rst Co-authored-by: gStart9 <106188942+gStart9@users.noreply.github.com> * Update site/source/support/faq/faq-startos.rst Co-authored-by: gStart9 <106188942+gStart9@users.noreply.github.com> * Update site/source/support/faq/faq-startos.rst Co-authored-by: gStart9 <106188942+gStart9@users.noreply.github.com> * Update site/source/support/faq/faq-startos.rst Co-authored-by: gStart9 <106188942+gStart9@users.noreply.github.com> * Update site/source/support/faq/faq-startos.rst Co-authored-by: gStart9 <106188942+gStart9@users.noreply.github.com> * Update site/source/support/faq/faq-troubleshooting.rst Co-authored-by: gStart9 <106188942+gStart9@users.noreply.github.com> * Update site/source/user-manual/upgrade-hardware/naspi-ssd-upgrade.rst Co-authored-by: gStart9 <106188942+gStart9@users.noreply.github.com> * Update site/source/user-manual/upgrade-hardware/naspi-ssd-upgrade.rst Co-authored-by: gStart9 <106188942+gStart9@users.noreply.github.com> --------- Co-authored-by: gStart9 <106188942+gStart9@users.noreply.github.com> --- site/source/support/external-support.rst | 4 - site/source/support/faq/faq-basic-use.rst | 36 +++++---- site/source/support/faq/faq-bitcoin.rst | 37 ++++------ site/source/support/faq/faq-contributing.rst | 2 +- site/source/support/faq/faq-general.rst | 48 ++++++------ site/source/support/faq/faq-lightning.rst | 38 ++++++---- .../support/faq/faq-service-packaging.rst | 2 +- site/source/support/faq/faq-services.rst | 53 +++++-------- site/source/support/faq/faq-startos.rst | 32 ++++---- .../support/faq/faq-troubleshooting.rst | 20 +++-- .../{backup-mount.rst => backup-advanced.rst} | 4 - site/source/user-manual/backups/index.rst | 3 +- .../connecting/connecting-lan/index.rst | 7 ++ .../tor-firefox/torff-android.rst | 2 +- .../tor-firefox/torff-linux.rst | 2 +- .../user-manual/device-guides/dg-android.rst | 3 - .../user-manual/device-guides/dg-ios.rst | 3 - .../user-manual/device-guides/dg-linux.rst | 4 +- .../user-manual/device-guides/dg-mac.rst | 8 +- .../user-manual/device-guides/dg-windows.rst | 3 - .../user-manual/device-guides/index.rst | 4 +- .../device-guides/limitations/index.rst | 16 ---- .../device-guides/limitations/lim-android.rst | 17 ----- .../device-guides/limitations/lim-ios.rst | 11 --- .../device-guides/limitations/lim-linux.rst | 7 -- .../device-guides/limitations/lim-mac.rst | 7 -- .../device-guides/limitations/lim-windows.rst | 9 --- .../upgrade-hardware/drive-upgrade.rst | 74 +++++++++++++++++++ .../user-manual/upgrade-hardware/index.rst | 34 ++++++--- ...{ssd-upgrade.rst => naspi-ssd-upgrade.rst} | 11 ++- .../upgrade-hardware/upgrade-pro.rst | 18 ++--- 31 files changed, 248 insertions(+), 271 deletions(-) rename site/source/user-manual/backups/{backup-mount.rst => backup-advanced.rst} (97%) delete mode 100644 site/source/user-manual/device-guides/limitations/index.rst delete mode 100644 site/source/user-manual/device-guides/limitations/lim-android.rst delete mode 100644 site/source/user-manual/device-guides/limitations/lim-ios.rst delete mode 100644 site/source/user-manual/device-guides/limitations/lim-linux.rst delete mode 100644 site/source/user-manual/device-guides/limitations/lim-mac.rst delete mode 100644 site/source/user-manual/device-guides/limitations/lim-windows.rst create mode 100644 site/source/user-manual/upgrade-hardware/drive-upgrade.rst rename site/source/user-manual/upgrade-hardware/{ssd-upgrade.rst => naspi-ssd-upgrade.rst} (96%) diff --git a/site/source/support/external-support.rst b/site/source/support/external-support.rst index 663e093..a621d12 100644 --- a/site/source/support/external-support.rst +++ b/site/source/support/external-support.rst @@ -68,10 +68,6 @@ Sphinx Chat * Official Support: support@stakwork.com * Community Support: https://t.me/joinchat/Fb4OcRo4LrRD6NXfsNdeeQ -Spark Wallet -============ -* https://sparkwallet.io/#sectionContact - Specter ========= * Official Support: https://t.me/spectersupport diff --git a/site/source/support/faq/faq-basic-use.rst b/site/source/support/faq/faq-basic-use.rst index 1f5b869..e4f4322 100644 --- a/site/source/support/faq/faq-basic-use.rst +++ b/site/source/support/faq/faq-basic-use.rst @@ -10,8 +10,8 @@ Basic Use FAQ Is it easy to use? ------------------ -Yes! A Start9 server is designed to be plugged into power and internet, and after a short setup, is immediately ready to use. Getting Services is as easy as getting apps for a smartphone. -As with anything new, you should expect to spend a little time learning the functions and features, and keep in mind that some Services may be more complex to understand and use than others. +Yes! A Start9 server is designed to be plugged into power and internet, and after a short setup, is immediately ready to use. Getting services is as easy as getting apps for a smartphone. +As with anything new, you should expect to spend a little time learning the functions and features, and keep in mind that some services may be more complex to understand and use than others. So I can run my own cloud? -------------------------- @@ -23,11 +23,11 @@ Yes, but there is currently no way to synchronize or federate them. We are work Can I still use my VPN? ----------------------- -The short answer is yes, but they can cause some conflicts when accessing your server. 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: +The short answer is yes, but they can cause some conflicts when accessing your server. 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 enabled: - Mullvad - Go to "Settings -> VPN Settings -> Local Network Sharing" - enable this option to be able to access your server's ``.local`` addresses. - ProtonVPN - Go to "Preferences -> Connection -> Allow LAN Connections" - enable this option to be able to access your server's ``.local`` addresses. -- IVPN - Go to "Settings -> IVPN Firewall -> LAN settings -> Allow LAN traffic when IVPN firewall is enabled" - enable this option to be able to access your server's ``.local`` addresses. +- iVPN - Go to "Settings -> IVPN Firewall -> LAN settings -> Allow LAN traffic when IVPN firewall is enabled" - enable this option to be able to access your server's ``.local`` addresses. What if I forget my StartOS password? ------------------------------------- @@ -47,20 +47,20 @@ No. The Tor Browser requires all web visits to first enter the Tor network. Once Can I use .local addresses on Android? -------------------------------------- -This will depend on your Android device. This support was added in Android 12. For custom ROMs, such as Calyx and Graphene, version 13 is required. +Yes. Support was added in version 12 of Android. For custom ROMs, such as Calyx and Graphene, version 13 is required. Can I have multiple users on StartOS? ----------------------------------------- -Currently, StartOS itself is designed for a single user. There is no way to grant others access to your server without sharing your personal, master password, which is not recommended. There are certain services, however, such as Bitwarden, File Browser, and Mastodon, that do support multiple users (aka multi-tenancy, aka the Uncle Jim model) where people who trust you (and vice versa) can create their own, personal accounts for these services. Just remind them that they are trusting you with their data, and that it might be preferable for them to take the final leap of self-sovereignty and get a server of their own. +------------------------------------- +Currently, StartOS itself is designed for a single user. There is no way to grant others access to your server without sharing your personal, master password, which is not recommended. There are certain services, however, such as Vaultwarden, File Browser, and Nextcloud, that do support multiple users (aka the "Uncle Jim" model) where people who trust you (and vice versa) can create their own, personal accounts for these services. Just remind them that they are trusting you with their data, and that it might be preferable for them to take the final leap of sovereignty and get a server of their own. Multi-tenancy is a desired future OS feature. Stay tuned. What can I do if I am having issues connecting to a mobile app over Tor? ------------------------------------------------------------------------ -Unfortunately, Orbot can be finicky. The best solution to connection issues is normally to restart Orbot, or to reboot the phone. This will solve most common problems. +The best solution to connection issues is normally to restart Orbot, or to reboot the phone. This will solve most common problems. -If I uninstall a service, then re-install it, does any data remain? -------------------------------------------------------------------- +If I uninstall a service, then re-install it, does my data remain? +------------------------------------------------------------------ No. When uninstalling a service, you completely destroy everything associated with it. This is because each service runs in it's own 'container', which includes all the required software and operating system environment that it needs to function. When uninstalling, this container is wiped from StartOS, and with it, any associated service data that you have not backed up. This can be useful, as you may want to wipe a service and start anew. For example, you might want to receive a fresh Tor .onion address, or to spin up a new Lightning node. However, if you do this, YOU MUST BE 100% CERTAIN THAT YOU ARE PREPARED TO LOSE ALL DATA for this service. Also, keep in mind that other services may depend on the service you are uninstalling. @@ -70,23 +70,21 @@ Do I need to delete existing backups before doing a new backup? Or does a new ba No, you don't need to delete the old backups. The technology we use updates the existing backup. This is known as a "diff-based" model, where the "difference" in backups is what is recorded. Can I clone my SSD for backup purposes? ------------------------------------------------ +--------------------------------------- .. warning:: **DO NOT do this if you are running LND or CLN**. If you clone the SSD, then go back to running LND or CLN, and you *ever* try to restore the SSD, there is a good chance you will lose *all your channel funds*. Also, if you try to use the SSD for a 2nd server, that will also result in loss of funds. This has nothing to do with Start9 or StartOS; it is inherent to the architecture of Lightning. -It is neither necessary, nor recommended to do this. The backup solution available in StartOS (v0.3.0+) allows all data to be written to another drive remotely, and this can mean another SSD, attached to a computer on your network. You may also do a backup to a local drive if it has external power. Please follow the directions in the backup UI for more details. +It is neither necessary, nor recommended to do this. If you need to copy all data to a new drive because you are migrating or upgrading hardware, check out the :ref:`"Transfer" option explained here`. Why would I even buy this when I can just build it for free? ------------------------------------------------------------ -(1) You will get white glove support in your preferred format, from email to text chat to screen sharing conference calls. +(1) You will get white glove support in your preferred format, from text chat to screen sharing conference calls. (2) Supporting the project. Buying a server from Start9 is your way of supporting the development of the project. And it's not just out of gratitude, but rather, a recognition that if the project isn't funded, the cool software stops coming. (3) Convenience. This is the big one. It's true, some people will choose to use the software without buying a server, but most will not. Very few people on Earth are comfortable using the command line, compiling code, and configuring an OS. Furthermore, hardware is necessary. Sure, some people already have a Raspberry Pi, and others may try to re-purpose an old laptop, but many people would be choosing between buying the hardware components themselves and assembling vs buying pre-assembled at a reasonable markup. -Bottom line...We are charging a very marginal rate for something incredibly powerful, and we think the convenience of a plug-and-play device, free service marketplace, and free white glove support is where the money is. Anyone could build their own couches too, but here is a reason furniture stores exist. How much is your time worth? +Bottom line...We are charging a marginal rate for something incredibly powerful, and we think the convenience of a plug-and-play device, free service marketplace, and white glove support is where the money is. Anyone could build their own couches too, but here is a reason furniture stores exist. How much is your time worth? -The fastest way to get support is via our `Community channels `_. Please do not hesitate to reach out! - -I bought a server from Start9 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. +My server came with a 'product key,' or similar unique code - what is that? +--------------------------------------------------------------------------- +This will entitle you to white glove support as well as future benefits yet to be announced. diff --git a/site/source/support/faq/faq-bitcoin.rst b/site/source/support/faq/faq-bitcoin.rst index 8bd5df9..169e97c 100644 --- a/site/source/support/faq/faq-bitcoin.rst +++ b/site/source/support/faq/faq-bitcoin.rst @@ -10,7 +10,7 @@ Bitcoin FAQ Why does the Bitcoin service take so long to be ready? ------------------------------------------------------ -On first install, the Bitcoin service must verify the entire history of transactions in order to verify transactions going forward. This can take up to a week depending on your internet connection. On a fast connection, you can expect 3-4 days. You can continue to use your server normally in the meantime. +On first install, the Bitcoin service must verify the entire history of transactions in order to verify transactions going forward. This can take up to a week depending on your hardware and internet connection. You can continue to use your server normally during this sync. You can learn more about the Initial Block Download in `this video `_. .. youtube:: OrYDehC-8TU @@ -18,17 +18,15 @@ You can learn more about the Initial Block Download in `this video `. Otherwise, the main way to actually *use* your node is through a wallet. The QT GUI is not usable because it cannot be served through the browser (which is necessary here), and last we checked, the QT desktop client was incapable of connecting to a remote node over Tor. +At present, StartOS does not offer its own node visualization tool (although this is planned). You can view certain properties about your node inside the "Properties" section, but not in an animated GUI. If you want to use bitcoin-cli, you may do so by adding an SSH key to your server and :ref:`exec-ing into the bitcoind docker container` (advanced). Otherwise, the main way to actually *use* your node is through a wallet. The QT GUI is not usable because it cannot be served through the browser (which is necessary here), and last we checked, the QT desktop client was incapable of connecting to a remote node over Tor. -Is a wallet vulnerable to hacking if it's always online?? +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. +Funds (private keys) are not typically stored on the node. 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 or paper wallet for better security. Though, to be fair, a lot of attacks depend on you or your machine being targeted specifically, and many 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). +Most successful attacks seem to be either fake/doctored software or a social attack (tricking you into installing some malware or giving up your private seed/keys). 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 server, 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 ensure 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 tampered with. - How do I use Bitcoin Core as a wallet? -------------------------------------- -Bitcoin Core is a full node that also contains wallet functionality. Some will be familiar with Bitcoin-QT, which is a Bitcoin Core GUI that for a long time was the only available wallet. This is currently not compatible with StartOS. -You can use the wallet in Bitcoin Core, however it is for advanced users and is only available in the command line via SSH. +Bitcoin Core is a full node that also contains wallet functionality. Some will be familiar with Bitcoin-QT, which is a Bitcoin Core GUI that for a long time was the only available wallet. This is currently not compatible with StartOS. 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 StartOS 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 Unix mantra of "do one thing and do it well." The recommended way to use your Bitcoin node is with an external wallet. -The available wallets are listed in the following FAQ. + +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 Unix mantra of "do one thing and do it well." The recommended way to use your Bitcoin node is with an :ref:`external wallet`. Which wallets can I use that integrate with my Bitcoin and/or Lightning nodes? ------------------------------------------------------------------------------ -Please see the :ref:`Bitcoin Service Guides` for all the current options. +Please see the :ref:`Bitcoin Integrations` and :ref:`Lightning Integrations` for all the currently supported options. I want to use my hardware signer, such as Coldcard or Trezor, with my Bitcoin node. How does this work? -------------------------------------------------------------------------------------------------------- -You do not use hardware signers directly with your node. Hardware signers interface with wallets, and wallets interface with nodes. +You do not use hardware signers directly with your node. Hardware signers interface with wallets, and wallets interface with nodes. Here is what the stack looks like: Node (on StartOS) <— Wallet (Specter, Sparrow, Electrum) <— Hardware signer (Coldcard, Trezor) -You would use your hardware signer with your wallet, then instruct that wallet to use your Bitcoin node as its node. +You use your hardware signer with your wallet, then instruct that wallet to use your Bitcoin node as its node. - Nodes are for interacting with the Bitcoin network: enforcing consensus rules, validating and relaying blocks/transactions, and broadcasting transactions. @@ -77,4 +70,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 StartOS). +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 many wallets do NOT support connecting to your own node. So, most wallets are actually serving as a wallet, linked to a third party 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 StartOS). diff --git a/site/source/support/faq/faq-contributing.rst b/site/source/support/faq/faq-contributing.rst index ec9c958..a77b539 100644 --- a/site/source/support/faq/faq-contributing.rst +++ b/site/source/support/faq/faq-contributing.rst @@ -17,6 +17,6 @@ Please follow the guide `here `_ page and please don't hesitate to `Contact `_ us for ideas if you're not sure where to begin. diff --git a/site/source/support/faq/faq-general.rst b/site/source/support/faq/faq-general.rst index 396a634..8facf41 100644 --- a/site/source/support/faq/faq-general.rst +++ b/site/source/support/faq/faq-general.rst @@ -10,7 +10,7 @@ General FAQ What is Start9 Labs? -------------------- -Start9 Labs is a small, but quickly growing group of builders based in Denver, CO (with a global team) that build Start9 servers and StartOS. +Start9 Labs is a small, but quickly growing group of builders based in Denver, USA (with a global team) that build Start9 servers and StartOS. What is a Start9 server? ------------------------ @@ -39,40 +39,40 @@ This `podcast `_ may help expound u How does StartOS work? ---------------------- -StartOS (see next question) is based on Linux and handles all operations on your server. This core element of the technology stack is what enables you to set up, login, access your server's dashboard, and install services. +StartOS (see next FAQ) is based on Linux and handles all operations on your server. This core element of the technology stack is what enables you to set up, login, access your server's dashboard, and install services. -One of these operations is creating and managing Tor addresses, which are uniquely attributed to each service you download, as well as to the server itself. You can see your uniquely generated Tor address when you complete the setup process using the Setup App. This address is how you view your server's dashboard, which is actually just a website hosted by your server itself! It is authenticated, of course, so only you can access it. +One of these operations is creating and managing Tor addresses, which are uniquely attributed to each service you download, as well as to the server itself. You can see your uniquely generated Tor address when you complete the setup process. This address is how you view your server's dashboard, which is actually just a website hosted by your server itself! It is authenticated, of course, so only you can access it. -You can connect to and manage your server from any mobile device, desktop computer, or laptop computer. This is accomplished right through the browser by visiting your server's private and unique URL. +You can connect to and manage your server from your mobile device, desktop computer, or laptop computer. This is accomplished in the browser by visiting your server's private and unique URL. Once on your server's web page (the StartOS dashboard), you can choose what services to install. Then, each installed service also receives its own private and unique URL, such that you can access it from the browser or any mobile app that supports using it as a backend. -The list of services will grow rapidly over the coming months and years, such that many things you currently do using cloud-based third party servers can be just as easily accomplished using your own personal cloud serving your own personal apps and storing your own private data. No trusted third parties at all. +The list of services will grow rapidly over the coming months and years, such that most or all the things you currently do using cloud-based third party servers can be just as easily accomplished using your own personal cloud serving your own personal software and storing your data privately. No trusted third parties at all. What is StartOS? ---------------- -StartOS is a new kind of Linux Operating System (OS). It is a built from the ground up to allow anyone to easily run their own "cloud," become independent from Big Tech, and own their own data. StartOS allows anyone to easily host their own software services. +StartOS is a new kind of Linux Operating System (OS). It is a built from the ground up to allow anyone to easily run a private "cloud," become independent from Big Tech, and own their own data. -StartOS is custom-built Linux distribution with a suite of software tools which make it easy to: +StartOS is custom-built Linux distribution (currently based on Debian) with a suite of software tools which make it easy to: -* Install, uninstall, and upgrade services from a Marketplace (similar to your phone's app store) +* Install, uninstall, and upgrade services from a Marketplace registry (similar to your phone's app store) * Manage and run services that YOU own and control * Upgrade StartOS with the latest features and security updates -* Backup services, and restore from backups if needed +* Backup services and data, and restore from backups if needed It includes: -* a custom application management layer, specialized for installing, running, and backing up .s9pk packaged services -* a layer responsible for StartOS specific operations, such as Tor, Backups, and Notifications -* a system of :ref:`Health Checks` for simple monitoring +* a custom application management layer, specialized for installing, running, and backing up ``.s9pk`` packaged services +* a layer responsible for StartOS specific operations, such as Networking, Backups, and Notifications +* a system of :ref:`Health Checks` for simple monitoring and metrics * an SDK for developers, including an "Actions" API to simplify complex operations for the common user -* and much, much more. Please see the corresponding :ref:`Concepts` section. +* and much, much more -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 a Marketplace registry. +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 a Marketplace registry. What are StartOS Services? -------------------------- -A Service can be any piece of software added to the Marketplace. Unlike "apps," services are (usually) "server-side" software, meaning they are intended to run 24/7/365 and listen for requests from your clients (apps). All services are "self-hosted," meaning that you are in complete control of your data. This means you can run your own "cloud!" Learn more about managing services :ref:`here ` and see our currently `Available Services `_. +A Service can be any piece of software added to a Marketplace registry. Unlike "apps," services are (usually) "server-side" software, meaning they are intended to run 24/7/365 and listen for requests from your clients (apps). All services are "self-hosted," meaning that you are in complete control of your data. This means you can run your own "cloud!" Learn more about managing services :ref:`here ` and see our currently `Available Services `_. Does Start9 ship worldwide? --------------------------- @@ -80,11 +80,11 @@ We ship everywhere that DHL ships. Please consider that in some countries, the Do you have international electrical plugs? ------------------------------------------- -Power supplies for EU, AU, US, and UK are available. +Power supplies for the EU, AU, US, and UK standards are usually available. -Is the power supply 220v compatible? ------------------------------------- -Yes. Start9 server power supplies are rated for 100-240V. +Are the power supplies 220v compatible? +--------------------------------------- +Yes. Start9 server power supplies are typically rated for 100-240V. Does StartOS have a license? ---------------------------- @@ -100,18 +100,16 @@ In general, any modern Internet connection is usually fine. We have had reports I run a business, can I use StartOS for tasks such as password management and file sharing? ------------------------------------------------------------------------------------------- -Absolutely. A Start9 server would be a great addition to any business as it is easy to use and provides services that you control, with no subscription fees. - -With the addition of `BTCPay Server `_, you can even run your own payment processor and accept cryptocurrency payments with no third party necessary! +Absolutely. A Start9 server would be a great addition to any business as it is easy to use and provides services that you control, with no subscription fees. You can even run your own payment processor and accept cryptocurrency payments with no third party necessary! What are you using for a store backend? Do you store my data? -------------------------------------------------------------- Here is our exact situation currently: -Server sales are processed through Shopify, which we do not like, but it was expedient in the early days, especially for shipping, so we went with it. Aside from a master list of email addresses for those who have explicitly opted in to our mailing list, all customer data is contained within Shopify. We do not duplicate it anywhere. We are asking Shopify to delete our customer data, but they claim it will take upward of 3 months to comply and we of course have no guarantee the data will actually be deleted permanently. This is partly why we exist...as such, we will be moving off of Shopify and onto a self-hosted solution, where Start9 alone controls our customer data for purchases, which we will delete as a matter of policy following a short grace period after delivery. +Credit card sales are processed through Shopify, which we do not like, but it was expedient in the early days, especially for shipping, so we went with it. Aside from a master list of email addresses for those who have explicitly opted in to our mailing list, all customer credit card data is stored within Shopify. We do not duplicate it anywhere. We ask Shopify to delete our customer data, but they claim it takes upward of 3 months to comply and we of course have no guarantee the data will actually be deleted permanently. This is partly why we exist...as such, we are moving off of Shopify and onto a self-hosted solution, where Start9 alone controls our customer data for purchases, which we will delete as a matter of policy following a short grace period after delivery. -In summary: (1) the shipping data we currently have is stored in Shopify (2) we are asking Shopify to delete all our customer data (3) we will be migrating off of Shopify (4) going forward, we alone will control customer data and will purge it regularly (5) you can always assemble the hardware yourself and just download StartOS for free. +Enter our `Bitcoin Store `_! Way less personal information is required to purchase with Bitcoin/Lightning, we offer a discount for these payment methods, and we routinely delete customer data. -We are currently working on a better solution. +Finally, you can always assemble the hardware yourself and download StartOS for free. I want to help, but I'm not a developer. Are there any ways for non-coders to contribute? ------------------------------------------------------------------------------------------ diff --git a/site/source/support/faq/faq-lightning.rst b/site/source/support/faq/faq-lightning.rst index e2bd2a1..d48a49d 100644 --- a/site/source/support/faq/faq-lightning.rst +++ b/site/source/support/faq/faq-lightning.rst @@ -46,23 +46,39 @@ How do I connect my Lightning wallet or mobile app to my Start9 server? ----------------------------------------------------------------------- Please see the :ref:`Lightning Service Guides` section for more details. -Are my addresses, channels, and balances all stored in LND or in RTL? Core Lightning or Spark, etc? ----------------------------------------------------------------------------------------------------- -This is all on LND, including on-chain funds, and RTL (or ThunderhHub, Zap, etc) is just a GUI for accessing LND. Same for Core Lightning, it contains all funds, channels, etc, and Spark, Zeus, etc are just GUIs to interface with the node. +Are my addresses, channels, and balances all stored in LND/Core Lightning, or RTL, Zeus, etc? +--------------------------------------------------------------------------------------------- +This is all on your Lightning node (LND or Core Lightning), including on-chain funds, while RTL (or Zap, Zeus, etc) is just a GUI for accessing your node. How do I find my LND seed so I can write it down to backup? ----------------------------------------------------------- -All LND backups are best done via StartOS's backup flow. It is not supported to use a seed as backup; LND does not expose this. Everything crucial is backed up by our backup system so you do not need your seed. The seed is ONLY for the onchain wallet and does not backup your channel state. +LND backups are best done via StartOS's backup flow, and this is the ONLY supported backup method. It is NOT supported to backup/restore from the seed. Everything crucial is backed up by our backup system, so you do not need the seed. The seed is ONLY for the onchain wallet and does NOT backup your channel state. That said, there was a high user demand to expose the LND Aezeed, and so, as of LND v0.16.4, this will be made available (on fresh installs only - as that is the only time Lightning Labs exposes this seed). -To clarify some of the reasons for this choice: +To clarify some of the reasons behind this issue: -First off, Lightning is fundamentally different than on-chain/Layer1(L1) bitcoin. There is no way to compress all of that information down into a single 24 word seed in such a way that it will continue to work throughout your usage of the Lightning Network. +First off, Lightning is fundamentally different than on-chain/Layer 1 (L1) Bitcoin. There is no way to compress all of that information down into a single 24 word seed in such a way that it will continue to work throughout your usage of the Lightning Network. -So, what is the LND seed *for*? In short, the seed is only used for the Layer1 portion of the funds you have locked up in LND. Due to the live nature of LND and lightning nodes in general, we tend to discourage keeping any significant amounts of money in the onchain portion of your wallet. Given that we cannot actually recover the Layer2(L2) funds with that seed, we needed to have a more holistic way to backup LND funds such that the backup would encompass the ability to get L2 funds back. The StartOS backup system does this, and this approach also happens to be a perfectly valid backup of your L1 funds as well. While Bitcoin users have been trained that the 24 word seed can be used to recover all of their funds, it is important to state that lightning does not and cannot work this way. Exposing the seed gives you two separate things to keep track of in order to recover your funds instead of just one. +So, what is the LND seed *for*? In short, the seed is only used for the Layer1 portion of the funds you have locked up in LND. Due to the live nature of LND and lightning nodes in general, we tend to discourage keeping any significant amounts of money in the onchain portion of your wallet. Given that we cannot actually recover the Layer 2 (L2) funds with that seed, we needed to have a more holistic way to backup LND funds such that the backup would encompass the ability to get L2 funds back. The StartOS backup system does this, and this approach also happens to be a perfectly valid backup of your L1 funds as well. While Bitcoin users have been trained that the 24 word seed can be used to recover all of their funds, it is important to understand that lightning does not and cannot work this way. Exposing the seed gives you two separate things to keep track of in order to recover your funds instead of just one. + +How does the StartOS backup system handle Lightning (CLN and LND) backups and recovery? +--------------------------------------------------------------------------------------- +CLN/LND backups on StartOS consist of onchain funds and the set of channels. The node implementations (upstream) do not contain channel balances in the backup systems they use. + +When you need to perform a recovery, it is important to understand all possible consequences. For most recoveries, such as a password reset, or hardware upgrade, there is no need to do a restore from backup. The preferred methods (:ref:`explained here`) are to "Attach" your existing data, or "Transfer" it. + +If you do need to do a disaster recovery, your node reaches out to channel counterparties and requests that they force close the channel at the current balances. You are "trusting" them to report the correct balances. "Trusting" in quotes, because it would be very dangerous for them to try to cheat. They have no way of knowing that you are unaware of the true channel state. If they try to broadcast a revoked channel state, you could take all their money. + +This is the current state of Lightning backups, and we will continue to stay at the forefront to help users protect their funds. + +Why are Lightning Network backups and moves so complicated? +----------------------------------------------------------- +There are safe ways to do an “atomic move” of a LN node, but it requires a very specific sequence of actions and certain mistakes can result in your counterparties taking all your funds. Currently, LN works on a punishment scheme. This means if you publish revoked state, the counterparty is entitled to a claim on all the funds in the channel. This incentive system is what makes the whole system work. Without it, LN would be subject to various kinds of thievery. + +The downside is that backups of old state are not safe. This is because your node might believe it is the real state of the channel, but it may be unaware of states created since then. The problem here is that your node naively believes something different from the truth, which can result in all of the funds being lost. In response to this reality, the safe backup systems, including those generated by RTL, actually do not include channel state. They only list the peers that you had channels with. Restoring these backups essentially politely asks your peers to force close the channels they have with you. In those moments it is possible for your peer to try and cheat you, but they cannot be 100% sure that you can't punish them, so it's extremely unlikely that they will attempt to do so. Is there a way to use the channel backups made within RTL? ---------------------------------------------------------- -The only backup flow we officially support is through StartOS's backup system. This does include the channel backups created automatically by LND, but it must be understood that backups in Lightning are very different than they are on Layer 1 Bitcoin. If you restore from backup all your channels will close, and there is a potential, albeit small, probability for you to lose funds. +We do not support this. Please see the above FAQ. When attempting to add new peer, RTL says "server is still in the process of starting," but chain state seems to be fully up to date. What can I do? ----------------------------------------------------------------------------------------------------------------------------------------------------- @@ -83,9 +99,3 @@ LND is waiting for Bitcoin to completely sync, and then needs to catch up on blo What's the best way to move a small lightning balance? ------------------------------------------------------ It is possible to have lightning balances that are so low that they will not (or barely will) cover the on-chain fees to recoup into an on-chain wallet. If possible, move them to another Lightning node. - -Why are Lightning Network backups and moves so complicated? ------------------------------------------------------------ -There are safe ways to do an “atomic move” of a LN node, but it requires a very specific sequence of actions and certain mistakes can result in your counterparties taking all your funds. Currently, LN works on a punishment scheme. This means if you publish revoked state, the counterparty is entitled to a claim on all the funds in the channel. This incentive system is what makes the whole system work. Without it LN would be subject to various kinds of thievery. - -The downside is that backups of old state are not safe. This is because your node might believe it is the real state of the channel, but it may be unaware of states created since then. The problem here is that your node naively believes something different from the truth, which can result in all of the funds being lost. In response to this reality, the safe backup systems, including those generated by RTL, actually do not include channel state. They only list the peers that you had channels with. Restoring these backups essentially politely asks your peers to force close the channels they have with you. In those moments it is possible for your peer to try and cheat you, but they cannot be 100% sure that you can’t punish them, so it’s extremely unlikely that they will attempt to do so. diff --git a/site/source/support/faq/faq-service-packaging.rst b/site/source/support/faq/faq-service-packaging.rst index 8d55313..bb93f14 100644 --- a/site/source/support/faq/faq-service-packaging.rst +++ b/site/source/support/faq/faq-service-packaging.rst @@ -10,7 +10,7 @@ Packaging FAQ Do I need programming experience to package a service for StartOS? ------------------------------------------------------------------ -It would be helpful, but is not a pre-requisite. Linux, dev-ops, and/or systems administration experience would all be helpful as well. Keep in mind that everyone has to start somewhere, and perhaps your journey to development begins with packaging a service for eOS! +It would be helpful, but is not a pre-requisite. Linux, dev-ops, and/or systems administration experience would all be helpful as well. Keep in mind that everyone has to start somewhere, and perhaps your journey to development begins with packaging a service for StartOS! What considerations are there when choosing a service for packaging? -------------------------------------------------------------------- diff --git a/site/source/support/faq/faq-services.rst b/site/source/support/faq/faq-services.rst index 57c7877..44d9055 100644 --- a/site/source/support/faq/faq-services.rst +++ b/site/source/support/faq/faq-services.rst @@ -12,50 +12,36 @@ What if I cannot connect to a Service? -------------------------------------- Please make sure the service is started by viewing it in the Services tab in the StartOS dashboard menu. A green indicator bar should be visible. -Can it be used as a firewall? ------------------------------ -Potentially. The PiHole service is on our wishlist. - Will there be a VPN? -------------------- -We are looking into adding Wireguard as a service for VPN access when you are not home. A client-to-client StartOS VPN may also be possible in the future. +There will be more on this style of functionality following StartOS v040. Will there be an email server? ------------------------------ -We do hope to add this functionality one day, however it has some technical challenges, and is not currently a high priority. If you would like to tackle this and help us get a self-hosted email server on StartOS, please reach out in our `Matrix Community Dev Channel `_, and we will be happy to help in any way that we can. +We do hope to add this functionality one day, however it has some technical challenges, and is not currently a high priority. If you would like to tackle this and help us get a self-hosted email server on StartOS, please reach out in our Matrix or Telegram `dev channels `_, and we will be happy to help in any way that we can. Can StartOS run 'X' Service?? --------------------------------- -Potentially. Here is a `comprehensive list `_ of self-hosted services, any of which can theoretically be run on StartOS. -To get a general idea of what is required of an app, answer these questions: +Potentially. Here is a `comprehensive list `_ of self-hosted services, any of which can theoretically be run on StartOS. To get a general idea of what is required, answer these questions: -1. Is it designed to be self-hosted? -2. Can it run on a Raspberry Pi? -3. If it has a P2P interface, does that interface support Tor? -4. Does it ship with it's own web interface? Or is there a Tor-enabled client app? -5. Is there someone willing to put in the time to package it up? +1. Is the software designed to be self-hosted? +2. If it has a P2P interface, does that interface support Tor? +3. Does it ship with it's own web interface? Or is there a Tor-enabled client app? +4. Is there someone willing to put in the time to package it up? -If all answers are yes, then it can run on StartOS. +If all answers are yes, then it can run on StartOS. Following OS v040, the Tor requirements will be dropped. Packing up a service for StartOS does not require extensive development skills. If you are interested in doing do, please see our :ref:`Developer Docs `. -We are aggressively moving away from service development in favor of a more community driven approach. Meaning you, an app development team, or anyone else on Earth, can bring the service they want to a Marketplace registry so anyone can run it on StartOS. You don't need our permission. +We are aggressively moving away from service development in favor of a more community driven approach. Meaning you, an app development team, or anyone else on Earth, can bring the service they want to a Marketplace registry so anyone can run it on StartOS. You don't need our permission. See more on our strategy in `this blog post `_. Does StartOS operate as a Tor relay node? ----------------------------------------- -No, currently it does not, but we plan to add that functionality in the near future. +No, currently it does not, but we plan to add that functionality as an option. -Are files on File Browser encrypted on disk? --------------------------------------------- -Yes, but not in a way that would prevent a sophisticated attacker. - -Can others use my Cups instance? How does that work? ----------------------------------------------------- -Cups does not have multiple accounts support. Each person would need their own Start9 server. We are considering adding multi-account support to Cups, but it's not a priority at the moment. - -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 Start9 server, then reinstall and import your keys. +Are files on my server encrypted on disk? +----------------------------------------- +Yes, but not in a way that would prevent a sophisticated attacker. Physical access should be considered root access. I get an error ("Unlock Wallet Failed") when trying to log in to RTL, what can I do? ------------------------------------------------------------------------------------ @@ -63,15 +49,14 @@ Stop and Restart the Service. What is happening if I cannot connect with another user on Mastodon? -------------------------------------------------------------------- -You can only follow someone who has an account on a Mastodon server that supports Tor. It is a new feature, so many instances do not have it yet. -Other issues are typically related to the tor connection, check your tor daemon, orbot, or try to restart the service. +You can only follow someone who has an account on a Mastodon server that supports Tor. It is a new feature, so many instances do not have it yet. Other issues are typically related to the tor connection, check your tor daemon, orbot, or try to restart the service. What does it mean when Vaultwarden says "This browser requires HTTPS to use the web vault" upon creating an account or loging in to my Vaultwarden onion? --------------------------------------------------------------------------------------------------------------------------------------------------------- You will need to tell your browser to treat .onion URLs as a "secure context". You will need to follow this guide to configure :ref:`Tor on Firefox`. Can the browser extension be used with Bitwarden hosted on StartOS? ------------------------------------------------------------------------ +------------------------------------------------------------------- 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. You can use your .local address, but remember that you will only be able to sync when on your :ref:`LAN`. @@ -80,13 +65,13 @@ I want to use BTCPayServer on my website, but Tor is the only option, how can vi -------------------------------------------------------------------------------------------------------------------- As StartOS produces a Tor Hidden Service for each service, BTCPayServer is only available via Tor by default. For a brick and mortar business, this is no problem as you can use your own device for a customer to pay you on. If you run your own website, it is possible to set up a reverse proxy in order to serve BTCPay content to your clearnet visitors. A guide to doing this is available in the `BTCPayServer docs `_. -We understand that this can be a frustrating limitation, and adding clearnet support is high on our list of priorities for StartOS. This will allow a number of services to have better interoperability with the broader Web. +We understand that this can be a frustrating limitation, and adding clearnet support is high on our list of priorities for StartOS (coming in v040). This will allow a number of services to have better interoperability with the broader Web. I'm having issues connecting to users or rooms in Matrix/Synapse, what can I do? -------------------------------------------------------------------------------- Most issues in Matrix will be due to improper setup, or tor connectivity issues. Please follow the directions in the Synapse web interface closely, and be sure that you have a good tor connection on the device you are trying to connect with. As with all Tor addresses, make sure you are using http:// as a prefix (some apps will automatically prefix https://. -Please reach out to us if you are still unable to connect. +Please reach out to support if you are still unable to connect. My Element desktop client stopped working after an OS update, what is happening? -------------------------------------------------------------------------------- @@ -94,9 +79,7 @@ If you had to create a custom destkop shortcut, it is likely that this was reset I don't see an answer to my question regarding a certain service. Is there more documentation? ----------------------------------------------------------------------------------------------- -While we are intent on providing the most friendly experience possible to our customers, ultimately it will be impossible for Start9 to create documentation and tutorials for every service we make available on StartOS. Each service *should* have its own documentation produced by the service developers themselves, and we will do our best keep track, consolidate, and link to it. Also, much of the reason good tutorials don't exist is simply because no one in the community has taken the time to produce it. If you come across something useful or write something up yourself, please let us know and we will promote it. Otherwise we will do our best to answer questions as they arise and gradually build out tutorials where they are lacking. - -Please also check out these :ref:`external support channels ` for assistance. +While we are intent on providing the most friendly experience possible to our customers, ultimately it will be impossible for Start9 to create documentation and tutorials for every service we make available on StartOS. Each service *should* have its own documentation produced by the service developers themselves, and we will do our best keep track, consolidate, and link to it in our :ref:`external support channels `. Also, much of the reason good tutorials don't exist is simply because no one in the community has taken the time to produce it. If you come across something useful or write something up yourself, please let us know and we will promote it. Otherwise we will do our best to answer questions as they arise and gradually build out tutorials where they are lacking. I want to understand in depth how a Service works and it's available configuration options. Where can I go to learn more? -------------------------------------------------------------------------------------------------------------------------- diff --git a/site/source/support/faq/faq-startos.rst b/site/source/support/faq/faq-startos.rst index b5311d0..0934ec2 100644 --- a/site/source/support/faq/faq-startos.rst +++ b/site/source/support/faq/faq-startos.rst @@ -14,25 +14,25 @@ Please see this :ref:`comparison page ` for a breakdown. Can I run StartOS on a VPS or VM? --------------------------------- -Yes! The :ref:`DIY Guide ` will take you through the setup steps. +Yes! The :ref:`DIY Guide ` has some details. Also check out our `Community Hub `_ to see guides and tips from Community members. Is it possible to use StartOS on my own hardware? ------------------------------------------------- -Yes! The :ref:`DIY Guide ` will take you through the setup steps. This option is great for people who already own the necessary hardware or who live outside the US and want to save on shipping and customs fees. +Yes! The :ref:`DIY Guide ` will take you through our guidelines. This option is great for people who already own some hardware or who live outside the US and want to save on shipping and customs fees. Additionally, StartOS is available for you to download or build from source under the Start9 Personal Use `License `_, for free. The caveat is that you will miss out on the perks that come along with purchasing from us, such as white-glove support, and others, which will grow over time. Do I plug my Start9 server into my computer? -------------------------------------------- -No. Your Start9 server only needs to be plugged into power and internet, just like your router. You can set it up right by your router and, similar to a router, generally forget about it. +No. Your Start9 server only needs to be plugged into power and internet, just like your router. You can set it up right by your router and, similar to a router, generally forget about it - as all access is via your other devices. Do I plug in a monitor, keyboard, and mouse? -------------------------------------------- -Typically, no. It is not necessary or recommended to do this as StartOS runs in "headless" mode - meaning that you will access it from your computer or mobile device. However, we have recently added "Kiosk Mode," which allows the installation (and use) of StartOS with a monitor/keyboard/mouse. For directions on setting this up, please check out the :ref:`x86 DIY Guide `. +Typically, no. It is not necessary or recommended to do this as StartOS runs in "headless" mode by default - meaning that you will access it from your computer or mobile device. However, we have recently added "Kiosk" mode, which allows the installation (and use) of StartOS with a monitor/keyboard/mouse. How much storage does a Start9 server have? ------------------------------------------- -Currently, Start9 servers ship with a 1 or 2TB SSD, but you may use a larger drive if you prefer. We advise against HDDs at this time for perfomance reasons. +Currently, Start9 servers ship with 128/256GB SD cards (Server Lite) and 1/2/4TB SSDs (Server One & Pure), but you may use a larger drive if you prefer. We advise **against** HDDs at this time for perfomance reasons. Are my Internet requests anonymous and secure? ---------------------------------------------- @@ -44,17 +44,17 @@ No. Your keys are generated on your device using the password you create so we Can multiple Start9 servers be setup to run redundantly in physically separate locations? ----------------------------------------------------------------------------------------- -Currently no, but we have plans for a feature that will enable StartOS to provide encrypted, automated backups across multiple servers. +Currently no, but we have plans for a feature that will enable StartOS to provide encrypted, automated backups across multiple servers. You can however, run as many servers as you'd like, copying data manually to each. How does StartOS compare to other Bitcoin nodes or personal servers? -------------------------------------------------------------------- -The cheapest way to run a Bitcoin/Lightning node is to buy a Raspberry Pi (or equivalent), download or compile Bitcoin, LND/CLN, etc, and host everything on Tor. This takes even technical people significant time to accomplish. On the other end of the spectrum is something like StartOS, which "just works". In between is stuff like MyNode, Nodl, RoninDojo, Umbrel, and Raspiblitz, which all require some degree of command line effort and network configuration. The biggest benefit of StartOS is that it is infinitely extensible to all of open-source, self-hosted software. The service listing will expand enormously over time in ways the other platforms may choose not to, or have difficulty implementing. +The cheapest way to run a Bitcoin/Lightning node is to buy a Raspberry Pi (or equivalent), download or compile Bitcoin, LND/CLN, etc, and host everything on Tor. This takes even technical people significant time to accomplish. On the other end of the spectrum is something like StartOS, which "just works". In between is stuff like MyNode, Nodl, RoninDojo, Umbrel, and Raspiblitz, which all require some degree of command line effort and manual configuration. The biggest benefit of StartOS is that it is infinitely extensible to all of open-source, self-hosted software. The service listing will expand enormously over time in ways the other platforms may choose not to, or have difficulty implementing. Would you consider (Umbrel, Nodl, RoninDojo, etc) a competitor to StartOS, or are they different enough to be compatible? -------------------------------------------------------------------------------------------------------------------------- Other node devices are competitors, and there are distinct trade-offs to each platform, but we are definitely moving toward the same future, which is a win for everyone! -One difference with Start9 is that we began with a plan to create an OS for general-purpose sovereign hosting of server-side software. No other project in the space (that we know of) started this way. There's also no reason you can't use more than one device. As an example, some users prefer StartOS for their data and RoninDojo for their Bitcoin stack. +One difference with Start9 is that we began with a plan to create an OS for general-purpose sovereign hosting of server-side software. No other project in this space (that we know of) started this way. There's also no reason you can't use more than one device. As an example, some users prefer StartOS for their data and RoninDojo for their Bitcoin stack. Some other things that StartOS offers that others do not: @@ -64,21 +64,23 @@ Some other things that StartOS offers that others do not: - Health Checks for quick-glance understanding of the status of your services - Unique user experiences created by service-packagers, including "Actions" (custom commands at the click of a button!) -From an architectural perspective, StartOS is a true operating system, giving you the ability to understand and control what is going on. Many other systems are black boxes offering little insight or agency to you. If something goes wrong, you'll have to put in your engineer hat and go command line diving. Lastly, our team is very responsive and helpful. We pride ourselves on providing incredible customer support. +From an architectural perspective, StartOS is a true operating system (of the Linux flavor), giving you the ability to understand and control what is going on. Many other systems are black boxes offering little insight or agency to you. If something goes wrong, you'll have to put in your engineer hat and go command line diving. Lastly, our team is very responsive and helpful. We pride ourselves on providing incredible customer support and education. -How can I migrate from Umbrel to StartOS and keep my lightning channels intact? -------------------------------------------------------------------------------- +How can I migrate from MyNode/Raspiblitz/Umbrel to StartOS and keep my lightning channels intact? +------------------------------------------------------------------------------------------------- We've created a guide to help you `transform your Umbrel's bitcoin stack into a Start9 server `_. Alternatively, if you have an Umbrel and a Start9 server and they're on the same network, you can just select *Services > Lightning Network Daemon > Actions > Import from Umbrel* in your Start9 server's web interface and your LND settings and channels will be automatically migrated. +As of LND v0.16.4, similar Actions are available for MyNode and Raspiblitz. + Can I mine Bitcoin with this? ----------------------------- -You do **not** want to do that. +You do **not** want to do that. Mining equipment is highly specialized, and this is not that. Does StartOS only work over Tor? No http or VPN? ------------------------------------------------- -StartOS's current primary communication is over Tor. In many cases we use HTTP over Tor (they are not mutually exclusive), you can see this by navigating to the Tor address in a browser and see the “http” in front of it. A VPN is a feature we're exploring as an alternative to Tor to make things faster without meaningfully impacting privacy. You can also connect directly via LAN if you are on the same network as your device. +Your server's services are currently primarily accessible over Tor. In many cases we use HTTP over Tor (they are not mutually exclusive), you can see this by navigating to the Tor address in a browser and see the “http” in front of it. Further networking options (and massive flexibility) are coming with StartOS v040. You can also connect directly via LAN if you are on the same network as your device. Which network traffic travels over tor and which does not? ---------------------------------------------------------- @@ -90,8 +92,8 @@ What if someone gets physical access to my device, can they read the contents? I ----------------------------------------------------------------------------------------------- The data is currently encrypted at rest, but not in a way that would prevent a sophisticated attacker from accessing it. This is a step towards better security in the near future. At-rest encryption on servers is a serious challenge, because of the need for remote availability. For example, you may not be at home to enter an encryption password following a power outage, leaving you without access to your server. -Services like Bitwarden, however, do not store plaintext information, so your passwords will not be compromised unless they know your master password. +Services like Vaultwarden, however, encrypt all user data, so your passwords will not be compromised unless they know your master password. Why http and not https for .onion websites? ------------------------------------------- -When visiting a Tor V3 URL (.onion website), your communications are end-to-end encrypted and onion-routed by default. There is no added benefit to using https. See this `article `_ from the Tor Project for more details. +When visiting a Tor V3 URL (.onion website), your communications are end-to-end encrypted and onion-routed by default. There is no added benefit to using https. See this `article `_ from the Tor Project for more details. You will notice that some services implement ``https`` for client compatibility reasons, however. diff --git a/site/source/support/faq/faq-troubleshooting.rst b/site/source/support/faq/faq-troubleshooting.rst index fc683a6..4285329 100644 --- a/site/source/support/faq/faq-troubleshooting.rst +++ b/site/source/support/faq/faq-troubleshooting.rst @@ -14,7 +14,7 @@ Please check out the :ref:`Initial Setup ` page, and follow the i 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` page. +After plugging into power and your router, if your device is equipped with a speaker, 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` page. Otherwise, your server is available on its unique ``adjective-noun.local`` or ``onion`` addresses. If something goes wrong, it will serve a diagnostic page on ``http://start.local``. My server is really hot! Is this normal? ----------------------------------------- @@ -22,12 +22,8 @@ On early devices, yes. These cases are actually doing 'double duty' as a heat s You can check the chip temperature of your device under "System -> Metrics". -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 start.local after hearing the start-up sounds. What do I do? ----------------------------------------------------------------------------- +I cannot reach start.local (for setup) 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 @@ -40,7 +36,7 @@ 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`. 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. +This dependency will no longer be required following StartOS v040. My Tor sites aren't loading, what should I do? ---------------------------------------------- @@ -48,13 +44,15 @@ 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 server over :ref:`LAN `, and restart it from the "System" menu. (Restart by removing power if you cannot access via LAN) +2. Access your server over :ref:`LAN `, and restart Tor from the "System" -> "Experimental Features" section. -3. Restart your router. +3. Restart your server. + +4. 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 server. Here's a `comic `_ 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 `_ explaining how to make strong passwords, simply. Bitwarden clients also all contain feature-rich password generation tools. What if I have an unique network issue, for example, with a firewall? --------------------------------------------------------------------- diff --git a/site/source/user-manual/backups/backup-mount.rst b/site/source/user-manual/backups/backup-advanced.rst similarity index 97% rename from site/source/user-manual/backups/backup-mount.rst rename to site/source/user-manual/backups/backup-advanced.rst index ab383e6..dd122c7 100644 --- a/site/source/user-manual/backups/backup-mount.rst +++ b/site/source/user-manual/backups/backup-advanced.rst @@ -4,10 +4,6 @@ Advanced Backup Tools ===================== -.. contents:: - :depth: 2 - :local: - .. warning:: The following are advanced tools and using them is only advised when under the instruction of a Start9 Support Technician. USE AT YOUR OWN RISK - these operations are not supported outside of the context of support. .. _backup-mount: diff --git a/site/source/user-manual/backups/index.rst b/site/source/user-manual/backups/index.rst index 6f5d92c..d8b75a1 100644 --- a/site/source/user-manual/backups/index.rst +++ b/site/source/user-manual/backups/index.rst @@ -3,7 +3,6 @@ ======= Backups ======= - In addition to the safe-keeping of a good master password, maintaining good backups is the major responsibility required to keep the benefits and freedom that come with self-hosting. .. raw:: html @@ -32,7 +31,7 @@ In addition to the safe-keeping of a good master password, maintaining good back .. topic-box:: :title: Advanced Backup Tools - :link: backup-mount + :link: backup-advanced :icon: scylla-icon scylla-icon--live-test :class: large-5 :anchor: View diff --git a/site/source/user-manual/connecting/connecting-lan/index.rst b/site/source/user-manual/connecting/connecting-lan/index.rst index 7e453fc..6e48e3f 100644 --- a/site/source/user-manual/connecting/connecting-lan/index.rst +++ b/site/source/user-manual/connecting/connecting-lan/index.rst @@ -37,3 +37,10 @@ Instruct your **client device** to trust your Start9 server's Root CA. Access your Start9 server's LAN Address --------------------------------------- With the Root CA downloaded and trusted by both your operating system and your browser, you can visit your Start9 server's LAN Address (.local URL) over secure ``https``. Any service that offers a LAN URL will also be securely accessible! + +.. toctree:: + :maxdepth: 2 + :hidden: + + lan-ff + lan-thunderbird diff --git a/site/source/user-manual/connecting/connecting-tor/tor-firefox/torff-android.rst b/site/source/user-manual/connecting/connecting-tor/tor-firefox/torff-android.rst index 502da23..66fc8f6 100644 --- a/site/source/user-manual/connecting/connecting-tor/tor-firefox/torff-android.rst +++ b/site/source/user-manual/connecting/connecting-tor/tor-firefox/torff-android.rst @@ -60,4 +60,4 @@ Once Tor is setup on your system, you can proceed to setup Firefox: #. Optional but recommended: search for ``network.http.referer.hideOnionsSource`` and set the value to ``true``. -#. Restart Firefox, and you're all set! You should now be able to navigate to ``.onion`` URLs in Firefox. This means you can bookmark Cups Messenger, or other Start9 services' ``.onion`` addresses, as well as use the :ref:`Bitwarden` browser extension. +#. Restart Firefox, and you're all set! You should now be able to navigate to ``.onion`` URLs in Firefox. This means you can bookmark your Start9 services' ``.onion`` addresses, as well as use integrations, such as the :ref:`Bitwarden` browser extension. diff --git a/site/source/user-manual/connecting/connecting-tor/tor-firefox/torff-linux.rst b/site/source/user-manual/connecting/connecting-tor/tor-firefox/torff-linux.rst index 7e6ee6a..7b3f48a 100644 --- a/site/source/user-manual/connecting/connecting-tor/tor-firefox/torff-linux.rst +++ b/site/source/user-manual/connecting/connecting-tor/tor-firefox/torff-linux.rst @@ -54,4 +54,4 @@ Configuring Firefox for Tor on Linux #. Click ``OK`` and then restart Firefox for the changes to take effect. -#. You're all set! You should now be able to navigate to ``.onion`` URLs in Firefox. This means you can access tor-only service :ref:`WebUIs `, such as Cups Messenger, and use your :ref:`Vaultwarden` Tor address in the `Bitwarden Firefox Plugin `_. You can test this by going to Start9's ``.onion`` homepage, `here `_. +#. You're all set! You should now be able to navigate to ``.onion`` URLs in Firefox. This means you can access tor service :ref:`WebUIs `, and use client integrations such as :ref:`Vaultwarden` apps and extensions. You can test this by going to Start9's ``.onion`` homepage, `here `_. diff --git a/site/source/user-manual/device-guides/dg-android.rst b/site/source/user-manual/device-guides/dg-android.rst index e8c3c08..da59675 100644 --- a/site/source/user-manual/device-guides/dg-android.rst +++ b/site/source/user-manual/device-guides/dg-android.rst @@ -3,11 +3,8 @@ ======= Android ======= - To optimize your device for use with your Start9 server, it is recommended to complete all of the following guides. -.. tip:: Please see Android's :ref:`Known Limitations` to understand what is currently not possible on these devices - * :ref:`lan-android` - Trust your Start9 server's Root Certificate Authority in order to securely connect over LAN. * :ref:`tor-android` - Run Tor natively (in the background) on your Android device. This will allow you to use applications on your machine via the Tor Network so they can communicate with your Start9 server. * :ref:`torff-android` - Configure Firefox to use the Tor Network so that you can reach ".onion" sites without needing to change browsers. diff --git a/site/source/user-manual/device-guides/dg-ios.rst b/site/source/user-manual/device-guides/dg-ios.rst index 18dc44a..488b57b 100644 --- a/site/source/user-manual/device-guides/dg-ios.rst +++ b/site/source/user-manual/device-guides/dg-ios.rst @@ -3,10 +3,7 @@ === iOS === - To optimize your device for use with your Start9 server, it is recommended to complete all of the following guides. -.. tip:: Please see iOS's :ref:`Known Limitations` to understand what is currently not possible on these devices - * :ref:`lan-ios` - Trust your Start9 server's Root Certificate Authority in order to securely connect over LAN. * :ref:`tor-ios` - Run Tor natively (in the background) on your iOS device. This will allow you to use applications on your device via the Tor Network so they can communicate with your Start9 server. diff --git a/site/source/user-manual/device-guides/dg-linux.rst b/site/source/user-manual/device-guides/dg-linux.rst index 8ed7b2a..f49ec52 100644 --- a/site/source/user-manual/device-guides/dg-linux.rst +++ b/site/source/user-manual/device-guides/dg-linux.rst @@ -3,11 +3,9 @@ ===== Linux ===== - To optimize your device for use with your Start9 server, it is recommended to complete all of the following guides. -.. tip:: Please see Linux's :ref:`Known Limitations` to understand what is currently not possible on these devices - +* :ref:`lan-linux` - Trust your Start9 server's Root Certificate Authority in order to securely connect over LAN. * :ref:`tor-linux` - Run Tor natively (in the background) on your Linux machine. This will allow you to use applications on your machine via the Tor Network so they can communicate with your Start9 server. * :ref:`torff-linux` - Configure Firefox to use the Tor Network so that you can reach ".onion" sites without needing to change browsers. * :ref:`backup-linux` - Configure a Network Folder on your Linux machine (or an attached external drive) for StartOS backups. diff --git a/site/source/user-manual/device-guides/dg-mac.rst b/site/source/user-manual/device-guides/dg-mac.rst index 2fc81f4..2803e7c 100644 --- a/site/source/user-manual/device-guides/dg-mac.rst +++ b/site/source/user-manual/device-guides/dg-mac.rst @@ -3,19 +3,15 @@ === Mac === - To optimize your device for use with your Start9 server, it is recommended to complete all of the following guides. -.. tip:: Please see Mac's :ref:`Known Limitations` to understand what is currently not possible on these devices - * :ref:`lan-mac` - Trust your Start9 server's Root Certificate Authority in order to securely connect over LAN. * :ref:`tor-mac` - Run Tor natively (in the background) on your Mac. This will allow you to use applications on your machine via the Tor Network so they can communicate with your Start9 server. * :ref:`torff-mac` - Configure Firefox to use the Tor Network so that you can reach ".onion" sites without needing to change browsers. * :ref:`backup-mac` - Configure a Network Folder on your Mac (or an attached external drive) for StartOS backups. Screensharing -_____________ - +------------- You may run into an issue and want to have a support call where we ask you to share your screen with us. While we understand if you'd rather not do this, it can make troubleshooting issues a lot easier. We will send you a Jitsi link and from there you can share your screen. If it doesn't work, please see the following instructions: .. tabs:: @@ -52,8 +48,6 @@ You may run into an issue and want to have a support call where we ask you to sh .. figure:: /_static/images/mac-stuff/jitsi-screenshare.png :width: 20% - - .. group-tab:: Ventura: #. Head to System Settings and scroll down to "Privacy & Security": diff --git a/site/source/user-manual/device-guides/dg-windows.rst b/site/source/user-manual/device-guides/dg-windows.rst index 721ad5e..196b66c 100644 --- a/site/source/user-manual/device-guides/dg-windows.rst +++ b/site/source/user-manual/device-guides/dg-windows.rst @@ -3,11 +3,8 @@ ======= Windows ======= - To optimize your device for use with your Start9 server, it is recommended to complete all of the following guides. -.. tip:: Please see Window's :ref:`Known Limitations` to understand what is currently not possible on these devices. - * :ref:`lan-windows` - Trust your Start9 server's Root Certificate Authority in order to securely connect over LAN. * :ref:`tor-windows` - Run Tor natively (in the background) on your Windows computer. This will allow you to use applications on your machine via the Tor Network so they can communicate with your Start9 server. * :ref:`torff-windows` - Configure Firefox to use the Tor Network so that you can reach ".onion" sites without needing to change browsers. diff --git a/site/source/user-manual/device-guides/index.rst b/site/source/user-manual/device-guides/index.rst index b355038..a2143d7 100644 --- a/site/source/user-manual/device-guides/index.rst +++ b/site/source/user-manual/device-guides/index.rst @@ -3,8 +3,7 @@ ============= Device Guides ============= - -Guides to get connected with or improve your Start9 server experience by device-type. +Guides for integrating your client devices with your Start9 server. .. toctree:: :maxdepth: 3 @@ -14,4 +13,3 @@ Guides to get connected with or improve your Start9 server experience by device- dg-windows dg-android dg-ios - limitations/index diff --git a/site/source/user-manual/device-guides/limitations/index.rst b/site/source/user-manual/device-guides/limitations/index.rst deleted file mode 100644 index 0a49da9..0000000 --- a/site/source/user-manual/device-guides/limitations/index.rst +++ /dev/null @@ -1,16 +0,0 @@ -.. _limitations: - -================= -Known Limitations -================= - -The following pages describe functionality that is known to be missing from certain platforms. Please bother the appropriate company or developers until they have been remedied. - -.. toctree:: - :maxdepth: 1 - - lim-linux - lim-mac - lim-windows - lim-android - lim-ios diff --git a/site/source/user-manual/device-guides/limitations/lim-android.rst b/site/source/user-manual/device-guides/limitations/lim-android.rst deleted file mode 100644 index cf0142d..0000000 --- a/site/source/user-manual/device-guides/limitations/lim-android.rst +++ /dev/null @@ -1,17 +0,0 @@ -.. _lim-android: - -======= -Android -======= - -.. contents:: - :depth: 2 - :local: - -LAN Access ----------- -Android versions below 12 do not have native support for :ref:`mDNS` and therefore cannot resolve ".local" addresses. LineageOS does not have this capability until LineageOS 20. - -Tor Firefox on LineageOS ------------------------- -There seems to be a bug in Lineage that makes using Firefox over Tor currently unusable. You must use TorBrowser to browse to .onion URLs. The feature works fine on Calyx and Graphene. diff --git a/site/source/user-manual/device-guides/limitations/lim-ios.rst b/site/source/user-manual/device-guides/limitations/lim-ios.rst deleted file mode 100644 index cefd8b2..0000000 --- a/site/source/user-manual/device-guides/limitations/lim-ios.rst +++ /dev/null @@ -1,11 +0,0 @@ -.. _lim-ios: - -=== -iOS -=== - -.. contents:: - :depth: 2 - :local: - -iOS has no known limitations in regard to StartOS. diff --git a/site/source/user-manual/device-guides/limitations/lim-linux.rst b/site/source/user-manual/device-guides/limitations/lim-linux.rst deleted file mode 100644 index 9898532..0000000 --- a/site/source/user-manual/device-guides/limitations/lim-linux.rst +++ /dev/null @@ -1,7 +0,0 @@ -.. _lim-linux: - -===== -Linux -===== - -Linux has no known limitations in regard to StartOS. diff --git a/site/source/user-manual/device-guides/limitations/lim-mac.rst b/site/source/user-manual/device-guides/limitations/lim-mac.rst deleted file mode 100644 index 706c770..0000000 --- a/site/source/user-manual/device-guides/limitations/lim-mac.rst +++ /dev/null @@ -1,7 +0,0 @@ -.. _lim-mac: - -=== -Mac -=== - -macOS has no known limitations in regard to StartOS. diff --git a/site/source/user-manual/device-guides/limitations/lim-windows.rst b/site/source/user-manual/device-guides/limitations/lim-windows.rst deleted file mode 100644 index 35a5e4a..0000000 --- a/site/source/user-manual/device-guides/limitations/lim-windows.rst +++ /dev/null @@ -1,9 +0,0 @@ -.. _lim-windows: - -======= -Windows -======= - -Windows10 has no known limitations in regard to StartOS at this time. - -No testing has been done with other versions, such as Windows 7 or 11. diff --git a/site/source/user-manual/upgrade-hardware/drive-upgrade.rst b/site/source/user-manual/upgrade-hardware/drive-upgrade.rst new file mode 100644 index 0000000..39e1a63 --- /dev/null +++ b/site/source/user-manual/upgrade-hardware/drive-upgrade.rst @@ -0,0 +1,74 @@ +.. _ssd-upgrade: + +================ +Upgrade Your SSD +================ +This guide will go over how to upgrade your data drive and transfer the data from the old one to the new one. This will preserve the entire state of your server, including all Tor and LAN addresses as well as channels you have open on the lightning network! You may like to do this in order to increase storage size, storage speed, or just to move your existing server data to new hardware entirely. + +This is not the same as running a back up and restoring them onto a new server. You can read about the differences on the :ref:`Restore page`. + +.. tip:: You will likely need a cable, adapter, or enclosure in order to attach your old drive via USB for data migration. + +Power Down and Exchange Hardware +-------------------------------- + +#. Start by shutting down your server: + + .. figure:: /_static/images/walkthrough/shutdown.png + :width: 50% + +#. Remove power and extract the existing drive from your device. + +#. Install the new drive, ideally in the same hardware slot as the previous drive. Be sure to secure with screws if applicable. + +Flash StartOS and Transfer Data +------------------------------- + +#. Flash your device with a fresh install of StartOS by following our :ref:`flashing guides `. + +#. Head to http://start.local from any device on the same LAN. + +#. Select "Recover". + + .. figure:: /_static/images/setup/screen0-startfresh_or_recover.png + :width: 30% + +#. Select "Transfer". + + .. figure:: /_static/images/setup/transfer.png + :width: 30% + +#. Now plug in the **old drive** to your server, using an adapter if necessary. + + .. tip:: Use the fastest possible data transfer method, especially if moving terabytes of data. + +#. Select the **old drive** - the one that is externally connected to your server, which you are migrating **from**. You may need to hit "REFRESH" if it does not appear: + + .. figure:: /_static/images/setup/transfer-from.png + :width: 30% + +#. Select the **new drive** (installed earlier) that you are migrating **to**. + + .. warning:: Any data on this new drive will be PERMANENTLY ERASED! BE CERTAIN that it is the correct drive. + + .. figure:: /_static/images/setup/transfer-to.png + :width: 30% + +#. You will be asked to create your master password. It can be the same as it was previously, or a new one. + + .. figure:: /_static/images/setup/screen5-set_password.png + :width: 30% + +#. Your data will now transfer. Keep in mind that the more data you have, the longer this process will take, possibly even days. + + .. note:: As an example, transferring 2TB of data from a Server Pure via a USB3.2 enclosure to a new 4TB NVMe drive can take upwards of 24hrs, including up to 14hrs of "initialization," while StartOS indexes all the data (at the beginning of the process). Please be patient. + + .. figure:: /_static/images/setup/screen6-storage_initialize.jpg + :width: 20% + +#. You are now ready to proceed and use your server with its new drive! It will have the same addresses and root certificate as it did before migrating. + + .. figure:: /_static/images/setup/screen7-startfresh_complete.jpg + :width: 30% + + .. warning:: Do not under any circumstances use your old drive to setup another server unless you wipe it first or wipe it during the initial setup process. If you have lightning channels you could lose all your funds! diff --git a/site/source/user-manual/upgrade-hardware/index.rst b/site/source/user-manual/upgrade-hardware/index.rst index d58ea9f..a441095 100644 --- a/site/source/user-manual/upgrade-hardware/index.rst +++ b/site/source/user-manual/upgrade-hardware/index.rst @@ -3,7 +3,7 @@ ================ Upgrade Hardware ================ - +Guides for migrating or upgrading your server's hardware. .. raw:: html @@ -11,6 +11,24 @@ Upgrade Hardware
+.. topic-box:: + :title: Upgrade SSD + :link: drive-upgrade + :icon: scylla-icon scylla-icon--benchmarks + :class: large-5 + :anchor: Upgrade + + This is for replacing or upgrading your SSD + +.. topic-box:: + :title: Upgrade SSD ('22 Server One) + :link: naspi-ssd-upgrade + :icon: scylla-icon scylla-icon--benchmarks + :class: large-5 + :anchor: Upgrade + + This is for replacing or upgrading your 2022 Server One SSD + .. topic-box:: :title: 2022 One to Pro Migration :link: upgrade-pro @@ -18,7 +36,7 @@ Upgrade Hardware :class: large-5 :anchor: Upgrade - This is for migrating from a Server One (Raspi) to Server Pro + This is for migrating from a Server One (Raspberry Pi) to Server Pro .. topic-box:: :title: Upgrade to all-in-one NASPi case @@ -29,15 +47,6 @@ Upgrade Hardware This is for upgrading a Pi to an all-in-one NASPi case -.. topic-box:: - :title: Upgrade SSD - :link: ssd-upgrade - :icon: scylla-icon scylla-icon--benchmarks - :class: large-5 - :anchor: Upgrade - - This is for replacing or upgrading your SSD - .. raw:: html
@@ -46,6 +55,7 @@ Upgrade Hardware :maxdepth: 2 :hidden: + SSD upgrade Pro upgrade NASPi upgrade - SSD upgrade + 2022 Server One SSD upgrade diff --git a/site/source/user-manual/upgrade-hardware/ssd-upgrade.rst b/site/source/user-manual/upgrade-hardware/naspi-ssd-upgrade.rst similarity index 96% rename from site/source/user-manual/upgrade-hardware/ssd-upgrade.rst rename to site/source/user-manual/upgrade-hardware/naspi-ssd-upgrade.rst index b0db187..0ca747a 100644 --- a/site/source/user-manual/upgrade-hardware/ssd-upgrade.rst +++ b/site/source/user-manual/upgrade-hardware/naspi-ssd-upgrade.rst @@ -1,14 +1,13 @@ -.. _ssd-upgrade: - -================ -Upgrade Your SSD -================ +.. _naspi-ssd-upgrade: +====================== +Upgrade Your NASPI SSD +====================== This guide will go over how to switch out an old drive on your server to a different drive and transfer the data from the old one to the new one. This will preserve the entire state of your server, including all Tor and LAN addresses as well as channels you have open on the lightning network! -This is not the same as backing up services and recovering them onto a new server. +This is not the same as running a back up and restoring them onto a new server. #. Start by shutting down your server: diff --git a/site/source/user-manual/upgrade-hardware/upgrade-pro.rst b/site/source/user-manual/upgrade-hardware/upgrade-pro.rst index 6bc1267..3f697c8 100644 --- a/site/source/user-manual/upgrade-hardware/upgrade-pro.rst +++ b/site/source/user-manual/upgrade-hardware/upgrade-pro.rst @@ -1,17 +1,16 @@ .. _upgrade-pro: -=============================================== -Transferring From 2022 Server One to Server Pro -=============================================== - -This guide is for Server One users upgrading from a NASPi (pictured below). If you're using a Samsung T5/T7 please go :ref:`here `. +============================================= +Migrating From 2022 Server One to Server Pure +============================================= +This guide is for Server One users upgrading from a NASPi (pictured below). If you're using an external drive, such as a Samsung T5/T7 please go :ref:`here `. .. figure:: /_static/images/hardware-pics/server-one.png :width: 30% You will need a high quality `USB-A to USB-A cable `_, or a `USB-A to USB-C cable `_. -#. Shutdown your Server One +#. Shutdown your Server One. .. figure:: /_static/images/walkthrough/shutdown.png :width: 60% @@ -97,10 +96,11 @@ You will need a high quality `USB-A to USB-A cable