restructure docs

site/source/misc-guides/data-mount.rst

@@ -0,0 +1,48 @@
+.. _data-mount:
+
+==================
+Mount a Data Drive
+==================
+
+If you have an encrypted disk from a prior StartOS installation, you can mount its decrypted contents on a Linux computer.
+
+.. warning:: This guide is advanced and should only be used when instructed by a Start9 technician.
+
+#. Attach the StartOS data drive to your Linux desktop or laptop computer.
+
+#. Ensure cryptsetup is installed:
+
+    .. code-block:: bash
+
+        sudo apt update && sudo apt install -y cryptsetup
+
+#. Enter the following command to reveal your disk's crypto_LUKS filesystems and their labels:
+
+    .. code-block:: bash
+
+        lsblk --fs
+
+    .. figure:: /_static/images/backups/disk-mount-1-lsblk.png
+        :width: 60%
+
+    We are interested in the services data so copy the long label ending with ``package-data``.
+
+#. Take that label, prepend ``/dev/mapper/`` to it, and feed it to ``cryptsetup``:
+
+    .. code-block:: bash
+
+        sudo cryptsetup open /dev/mapper/EMBASSY_NBMVE7OASAPTIIXNEPFN6PLAPJNT72F2XAVK43L2PGB6O2JRB35A-package--data startos_data_unlocked
+    
+    You will be prompted for the password to decrypt the filesystem which is ``password``, and a new device mapping called `startos_data_unlocked` will be created.
+
+#. Mount the `startos_data_unlocked` device at a path of your choosing.  Here, we will use ``/mnt/startos_data``:
+
+    .. code-block:: bash
+
+        sudo mkdir /mnt/startos_data
+        sudo mount /dev/mapper/startos_data_unlocked /mnt/startos_data
+
+#. Inspect the decrypted files in preparation for copying via ``cp``, ``scp``, ``rsync`` or similar utility:
+
+    .. figure:: /_static/images/backups/disk-mount-3-inspect.png
+        :width: 60%