Files
documentation/site/source/guides/misc-guides/data-mount.rst
Lucy ddebb08873 Update/035 (#529)
* update initial setup images and some copy

* rename backups

* cleanup and fix build errors

* reconfigure for 035 deployment

* Alignment

* Initial Root CA trust

* Wording touchups and Pro>Pure

* Remove extraneous message

* Simplify anchor text

* restructure backups

* update setup wizard screenshots

* Update firmware link and filename

* update branches list

* copy updates

* update copy to make anchor tags cleaner

* Remove FAQ, link to website FAQ

* add missing troubleshooting links

---------

Co-authored-by: gStart9 <george@start9labs.com>
Co-authored-by: Matt Hill <mattnine@protonmail.com>
Co-authored-by: agent <kn0wmad@protonmail.com>
2023-11-03 13:16:52 -06:00

49 lines
1.6 KiB
ReStructuredText

.. _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%