From 45f681ed167b06dd0fd73f2b0877d4a14eed4cae Mon Sep 17 00:00:00 2001 From: Stuart Date: Fri, 5 Jul 2024 18:29:53 +0200 Subject: [PATCH] Integration of SouthernBitcoiner video and related initial setup reforms --- site/source/user-manual/index.rst | 2 +- site/source/user-manual/initial-setup.rst | 35 ------------ .../user-manual/initial-setup/index.rst | 13 +++++ .../initial-setup/initial-setup-recovery.rst | 28 +++++++++ .../initial-setup-start-fresh.rst | 57 +++++++++++++++++++ 5 files changed, 99 insertions(+), 36 deletions(-) delete mode 100644 site/source/user-manual/initial-setup.rst create mode 100644 site/source/user-manual/initial-setup/index.rst create mode 100644 site/source/user-manual/initial-setup/initial-setup-recovery.rst create mode 100644 site/source/user-manual/initial-setup/initial-setup-start-fresh.rst diff --git a/site/source/user-manual/index.rst b/site/source/user-manual/index.rst index 6e1a5ad..210487d 100644 --- a/site/source/user-manual/index.rst +++ b/site/source/user-manual/index.rst @@ -8,7 +8,7 @@ User Manual :includehidden: :maxdepth: 2 - initial-setup + initial-setup/index trust-ca connecting-lan connecting-tor diff --git a/site/source/user-manual/initial-setup.rst b/site/source/user-manual/initial-setup.rst deleted file mode 100644 index 929fe81..0000000 --- a/site/source/user-manual/initial-setup.rst +++ /dev/null @@ -1,35 +0,0 @@ -.. _initial-setup: - -============= -Initial Setup -============= - -.. _fresh-setup: - -Starting Fresh --------------- -#. Connect your server to power and ethernet. - -#. From a client device (desktop/laptop/phone) connected to the same local network as your server, open a browser and visit ``http://start.local``. - - .. note:: If you are `not` using a Raspberry Pi, you can also plug a monitor and keyboard into the server. This is known as "Kiosk mode". - -#. Follow the on-screen instructions. - -.. _recover-options: - -Recover Options ---------------- -If you are using an existing drive, transferring data from one drive to another, or restoring your entire system from a backup, follow the appropriate guide below: - - - :ref:`Use Existing Drive ` - - :ref:`Transfer ` - - :ref:`Restore from Backup ` - -.. _setup-troubleshooting: - -Troubleshooting ---------------- -If you followed the above instructions and are experiencing issues, click :ref:`here ` to resolve. - -You can also to `reach out to support `_ if you need a hand. diff --git a/site/source/user-manual/initial-setup/index.rst b/site/source/user-manual/initial-setup/index.rst new file mode 100644 index 0000000..7614ea5 --- /dev/null +++ b/site/source/user-manual/initial-setup/index.rst @@ -0,0 +1,13 @@ +.. _initial-setup: + +=============================== +Getting Started - Initial Setup +=============================== + +A self-hosting experience with StartOS begins with setting up your server for the first time or by wiping an existing server to completely start over. For both of these, choose `Start Fresh`. To transfer existing server data to a new machine or disk or to perform a disaster recovery from backups, choose `Recovery or Restore`. + +.. toctree:: + :maxdepth: 1 + + initial-setup-start-fresh + initial-setup-recovery \ No newline at end of file diff --git a/site/source/user-manual/initial-setup/initial-setup-recovery.rst b/site/source/user-manual/initial-setup/initial-setup-recovery.rst new file mode 100644 index 0000000..4621d1a --- /dev/null +++ b/site/source/user-manual/initial-setup/initial-setup-recovery.rst @@ -0,0 +1,28 @@ +.. _initial-setup-recovery: + +============= +Recovery or Restore +============= + +.. contents:: + :depth: 2 + :local: + +Keeping existing data +--------------------- + +These options assume you have a working StartOS device or data disk containing StartOS services and configurations that you want to use as the source for your new server. + + + - :ref:`Use Existing Drive ` + - :ref:`Transfer ` + + +Emergency Restore from Backup +----------------------------- +This option assumes that disaster has struck and your only copy of your StartOS services are backups taken through StartOS. + + - :ref:`Restore from Backup ` + + + diff --git a/site/source/user-manual/initial-setup/initial-setup-start-fresh.rst b/site/source/user-manual/initial-setup/initial-setup-start-fresh.rst new file mode 100644 index 0000000..e30c56e --- /dev/null +++ b/site/source/user-manual/initial-setup/initial-setup-start-fresh.rst @@ -0,0 +1,57 @@ +.. _initial-setup-starting-fresh: + +============= +Start Fresh +============= + +.. contents:: + :depth: 2 + :local: + +Setting up a new server +----------------------- + +The video below demonstrations how to set up a newly purchased Start9 server. If you are familar with the process or you have recently :ref:`flashed <_flashing>` an existing server, you may want to skip the video and scroll down straight to Step 1. + + + .. youtube:: DzikmY4S42Y + :width: 100% + + + +**First Steps** + +#. Connect your server to power and ethernet. + +#. From a client device (desktop/laptop/phone) connected to the same local network as your server, open a browser and visit ``http://start.local``. + + .. note:: If you are `not` using a Raspberry Pi, you can also plug a monitor and keyboard into the server. This is known as "Kiosk mode" but is not recommedend for general use. + +#. Follow the on-screen instructions. + +_________ + + +Start Over +-------------- + +To `Factory Reset` an existing server, you must first go through the flashing process to reinstall StartOS. + +#. Flash your device with a fresh install of StartOS by following the :ref:`flashing guides `, making sure to select `Factory Reset` when booting from external media. + +#. After install is complete, you will be prompted to remove your external and restart. + + .. note:: On a Raspberry Pi, you will `not` remove the microSD card you have flashed, it will remain in the device. + +#. From a client device (desktop/laptop/phone) connected to the same local network as your server, open a browser and visit ``http://start.local``. + +#. Choose `Start Fresh` and follow the on-screen instructions. + +_________ + + +Troubleshooting +--------------- +If you followed the above instructions and are experiencing issues, click :ref:`here ` to resolve. + +You can also to `reach out to support `_ if you need a hand.