Backup updates

site/03-todo.md

@@ -45,3 +45,10 @@
 - Alt Market Build Guide
 # About
     - Mission / values
+- Backups
+    - CIFS
+        - OS guides for CIFS
+    - Local
+- Migrations
+- Bug reports
+- Diag UI

site/source/support/index.rst

@@ -30,7 +30,7 @@
   :class: large-4
   :anchor: View
 
-  All you need to be an owner/operator of your own self-hosted software
+  All you need to be the owner/operator of your own self-hosted software
 
 .. topic-box::
   :title: FAQ

site/source/support/user-manual/configuration/backup-setup/backup-lin.rst

@@ -0,0 +1,46 @@
+.. _backup-lin:
+
+=====
+Linux
+=====
+
+Remote Backups
+--------------
+
+The following will guide you through the prerequisite configuration to backup to a Linux machine or an external drive that is attached to a Linux machine.
+
+.. tabs::
+
+    .. group-tab:: Ubuntu
+
+        #. Open the file manager
+
+        #. Right-click the folder that you want to share and click ``Local Network Share`` from the menu.
+
+        #. In the resulting window, select the check box for ``Share this folder`` and then check the boxes for ``Allow others to create and delete files in this folder`` and ``Guest access``.
+
+        #. (Optional) Create a description in the ``Comment`` section
+
+        #. Click ``Create Share``
+
+        #. Click ``Add the permissions automatically``
+
+        #. That's it!  Now you can make encrypted backups to your own, private "cloud" by using the :ref:`Backup flow<backups>`` in the Embassy UI.
+
+            .. figure:: /_static/images/
+
+
+    .. group-tab:: Other Linux
+
+        #. Install Samba if it is not already installed
+
+            * ``sudo pacman -S samba``                                      For Arch
+            * ``sudo apt install samba``                                    For Debian
+            * ``sudo yum install samba``                                    For CentOS/Redhat
+            * ``sudo dnf install samba``                                    For Fedora
+
+        #. Create a directory to share or choose an existing one
+
+        #. Configure Samba
+
+        #. Add your user to Samba and "own" the directory if you do not already

site/source/support/user-manual/configuration/backup-setup/index.rst

@@ -1,4 +1,4 @@
-.. _backup:
+.. _backup-setup:
 
 =======
 Backups

site/source/support/user-manual/configuration/index.rst

@@ -10,8 +10,8 @@ Configuration, setup guides, and known limitations are provided here by device.
   :maxdepth: 2
 
   basic-config
+  backup-setup/index
   tor-setup/index
   lan-setup/index
   wifi
-  sessions
   limitations/index

site/source/support/user-manual/walkthrough/backup/backup-lin.rst

@@ -1,38 +0,0 @@
-.. _backup-lin:
-
-=====
-Linux
-=====
-
-There are 2 options for backing up your Embassy and all its service data.  You can setup a shared folder on a remote machine, such as a laptop or desktop, or you can backup to a local drive, which must be externally powered or plugged into a powered USB hub before plugging into Embassy.
-
-Remote Backups
---------------
-
-Ubuntu
-======
-
-#. Open the file manager
-#. Right-click the folder that you want to share and click ``Local Network Share`` from the menu.
-#. In the resulting window, select the check box for ``Share this folder`` and then check the boxes for Allow others to create and delete files in this folder and Guest access.
-#. (Optional) Create a description in the ``Comment`` section
-#. Click ``Create Share``
-#. Click ``Add the permissions automatically``
-#. Next, in your Embassy interface, go to ``Embassy`` -> ``Create Backup``
-
-Other Linux
-===========
-
-#. Install Samba
-    # sudo yum install samba                                    For CentOS/Redhat
-    # sudo dnf install samba                                    For Fedora
-    # sudo apt install samba                                    For Debian
-    # sudo pacman -S samba                                      For Arch
-
-Local Backups
--------------
-
-#. With Embassy powered down, plug in your external drive to the powered hub if you are using one, or directly into Embassy's available USB 3.0 (blue) slot if it is externally powered.
-#. Plug in power to your hub or drive
-#. Boot Embassy and go to ``Embassy`` -> ``Create Backup``
-#.

site/source/support/user-manual/walkthrough/backups.rst

@@ -0,0 +1,60 @@
+.. _backups:
+
+==============
+Making Backups
+==============
+
+There are 2 options for backing up your Embassy and all its service data.  You can setup a shared folder on a remote machine, such as a laptop, desktop, or external drive on your network, or you can backup to a local drive, which must be externally powered or plugged into a powered USB hub before plugging into Embassy.
+
+.. note:: For remote backups, you will first need to configure the machine you want to backup to.  Check our :ref:`Backup Setup<backup-setup>` guide for your OS first.
+
+Remote Backups
+--------------
+
+#. Go to the :ref:`Embassy tab<embassy-tab>`, then click on ``Create Backup``.
+
+    .. figure:: /_static/images/config/embassy_backup.svg
+        :width: 60%
+
+#. Next, click on ``+ New Shared Folder`` to use your previously created backup folder.
+
+    .. figure:: /_static/images/config/embassy_backup0.svg
+        :width: 60%
+
+#. Fill in the following fields:
+
+    * Hostname - This is the hostname of the machine that your folder or drive is located on
+    * Path - This is the directory path to the shared folder.  If you setup Samba yourself (Linux), this may be the name of the share in your samba config file and not the path.
+    * Username - This is the user on the remote machine that you used to create the shared directory
+    * Password - This is your user (from above) password
+
+    .. figure:: /_static/images/config/embassy_backup1.svg
+        :width: 60%
+
+    Then click ``Save``
+
+#. You will see a freshly created "cloud" backup location available, click it for options, and click ``Create Backup`` to begin.
+
+    .. figure:: /_static/images/config/embassy_backup2.svg
+        :width: 60%
+
+#. You can continue to use your Embassy while the backup is in progress.
+
+    .. figure:: /_static/images/config/embassy_backup3.svg
+        :width: 60%
+
+#. When the backup is complete you will be notified in the :ref:`Notifications tab<notifications-tab>`, and you will see the date and time of your most recent backup updated under ``Backups`` in the Embassy tab.
+
+    .. figure:: /_static/images/config/embassy_backup4.svg
+        :width: 60%
+
+Local Backups
+-------------
+
+#. With Embassy powered down, plug in your external drive to the powered hub if you are using one, or directly into Embassy's available USB 3.0 (blue) slot if it is externally powered.
+
+#. Plug in power to your hub or drive
+
+#. Boot Embassy and go to ``Embassy`` -> ``Create Backup``
+
+#.

site/source/support/user-manual/walkthrough/index.rst

@@ -11,7 +11,8 @@ An overview of EmbassyOS general capabilities.
 
   overview
   updates
-  backup/index
+  backups
   password
+  sessions