diff --git a/poetry.lock b/poetry.lock index 7b9ccb5..c7853c9 100644 --- a/poetry.lock +++ b/poetry.lock @@ -72,11 +72,11 @@ python-versions = ">=3.6" [[package]] name = "charset-normalizer" -version = "2.0.12" +version = "2.1.0" description = "The Real First Universal Charset Detector. Open, modern and actively maintained alternative to Chardet." category = "main" optional = false -python-versions = ">=3.5.0" +python-versions = ">=3.6.0" [package.extras] unicode_backport = ["unicodedata2"] @@ -305,7 +305,7 @@ sphinx = ">=1.3.1" [[package]] name = "requests" -version = "2.28.0" +version = "2.28.1" description = "Python HTTP for Humans." category = "main" optional = false @@ -313,13 +313,13 @@ python-versions = ">=3.7, <4" [package.dependencies] certifi = ">=2017.4.17" -charset-normalizer = ">=2.0.0,<2.1.0" +charset-normalizer = ">=2,<3" idna = ">=2.5,<4" urllib3 = ">=1.21.1,<1.27" [package.extras] socks = ["PySocks (>=1.5.6,!=1.5.7)"] -use_chardet_on_py3 = ["chardet (>=3.0.2,<5)"] +use_chardet_on_py3 = ["chardet (>=3.0.2,<6)"] [[package]] name = "six" @@ -688,8 +688,8 @@ certifi = [ {file = "certifi-2022.6.15.tar.gz", hash = "sha256:84c85a9078b11105f04f3036a9482ae10e4621616db313fe045dd24743a0820d"}, ] charset-normalizer = [ - {file = "charset-normalizer-2.0.12.tar.gz", hash = "sha256:2857e29ff0d34db842cd7ca3230549d1a697f96ee6d3fb071cfa6c7393832597"}, - {file = "charset_normalizer-2.0.12-py3-none-any.whl", hash = "sha256:6881edbebdb17b39b4eaaa821b438bf6eddffb4468cf344f09f89def34a8b1df"}, + {file = "charset-normalizer-2.1.0.tar.gz", hash = "sha256:575e708016ff3a5e3681541cb9d79312c416835686d054a23accb873b254f413"}, + {file = "charset_normalizer-2.1.0-py3-none-any.whl", hash = "sha256:5189b6f22b01957427f35b6a08d9a0bc45b46d3788ef5a92e978433c7a35f8a5"}, ] colorama = [ {file = "colorama-0.4.5-py2.py3-none-any.whl", hash = "sha256:854bf444933e37f5824ae7bfc1e98d5bce2ebe4160d46b5edf346a89358e99da"}, @@ -842,8 +842,8 @@ recommonmark = [ {file = "recommonmark-0.5.0.tar.gz", hash = "sha256:a520b8d25071a51ae23a27cf6252f2fe387f51bdc913390d83b2b50617f5bb48"}, ] requests = [ - {file = "requests-2.28.0-py3-none-any.whl", hash = "sha256:bc7861137fbce630f17b03d3ad02ad0bf978c844f3536d0edda6499dafce2b6f"}, - {file = "requests-2.28.0.tar.gz", hash = "sha256:d568723a7ebd25875d8d1eaf5dfa068cd2fc8194b2e483d7b1f7c81918dbec6b"}, + {file = "requests-2.28.1-py3-none-any.whl", hash = "sha256:8fefa2a1a1365bf5520aac41836fbee479da67864514bdb821f31ce07ce65349"}, + {file = "requests-2.28.1.tar.gz", hash = "sha256:7c5599b102feddaa661c826c56ab4fee28bfd17f5abca1ebbe3e7f19d7c97983"}, ] six = [ {file = "six-1.16.0-py2.py3-none-any.whl", hash = "sha256:8abb2f1d86890a2dfb989f9a77cfcfd3e47c2a354b01111771326f8aa26e0254"}, diff --git a/site/source/_static/images/config/embassy_backup1.png b/site/source/_static/images/config/embassy_backup1.png index 3aa9222..8667ad0 100644 Binary files a/site/source/_static/images/config/embassy_backup1.png and b/site/source/_static/images/config/embassy_backup1.png differ diff --git a/site/source/user-manual/backups/backup-setup/backup-linux.rst b/site/source/user-manual/backups/backup-setup/backup-linux.rst index 200db74..e8827c3 100644 --- a/site/source/user-manual/backups/backup-setup/backup-linux.rst +++ b/site/source/user-manual/backups/backup-setup/backup-linux.rst @@ -7,20 +7,26 @@ Linux LAN Shared Folder .. contents:: :depth: 2 :local: - -Check out the video below, and follow along with the steps in this guide to setup a LAN Shared folder on your Linux machine, such that you may create encrypted, private backups of all your Embassy data. - - .. youtube:: LLIMC5P3NdY - :width: 100% Setup LAN Shared Folder ----------------------- +.. note:: This guide is for Ubuntu only. For different distros such as Arch, Debian, Pop-OS, PureOS, etc, click "Other Linux" below. + .. tabs:: .. group-tab:: Ubuntu - #. Install ``Samba`` if you have not already: + Check out the video below, and follow along with the steps in this guide to setup a LAN Shared folder on your Linux machine, such that you may create encrypted, private backups of all your Embassy data. + + .. youtube:: LLIMC5P3NdY + :width: 100% + + .. raw:: html + +

+ + #. Install Samba if you have not already: .. code-block:: @@ -70,26 +76,26 @@ Setup LAN Shared Folder #. Install Samba if it is not already installed. * ``sudo pacman -S samba`` For Arch - * ``sudo apt install samba`` For Debian + * ``sudo apt install samba`` For Debian-based distros (Pop-OS, PureOS, etc) * ``sudo yum install samba`` For CentOS/Redhat * ``sudo dnf install samba`` For Fedora - #. Create a directory to share or choose an existing one and make note of its location (path). For this example, it will be called ``test-backup`` and located at ``/home/user/test-backup`` + #. Create a directory to share or choose an existing one and make note of its location (path). For this example, we will call the share ``backup-share`` and its corresponding shared directory will be located at ``/home/user/embassy-backup`` - #. Configure Samba, by adding the following to the end of the ``/etc/samba/smb.conf`` file: + #. Configure Samba by adding the following to the end of the ``/etc/samba/smb.conf`` file: .. code-block:: - [test-share] - path = /home/user/test-backup - create mask = 0666 - directory mask = 0777 + [backup-share] + path = "/home/user/embassy-backup" + create mask = 0600 + directory mask = 0700 read only = no guest ok = no Where: - - ``[test-share]`` is the *Share Name*, or title of the entry, and can be called anything you'd like + - ``[backup-share]`` is the *Share Name*, or title of the entry, and can be called anything you'd like - ``path`` should be the path to the directory you created earlier Copy the remainder of the entry exactly as it is @@ -100,7 +106,7 @@ Setup LAN Shared Folder sudo smbpasswd -a YOUR-USER - Create a password and keep it somewhere safe, such as Vaultwarden + This creates a password for the Local Network Share. Keep it somewhere safe, such as Vaultwarden. Connect Embassy @@ -119,9 +125,9 @@ Connect Embassy #. Fill in the following fields: * Hostname - This is the hostname of the machine that your shared folder is located on - * Path - This is the "Share Name" (name of the share in your samba config) and **not** the full directory 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 + * Path - This is the "Share Name" (name of the share in your samba config) and **not** the full directory path. In this guide we used ``backup-share`` + * Username - This is your Linux username on the remote machine that you used to create the shared directory + * Password - This is the password you set above using ``smbpasswd`` .. figure:: /_static/images/config/embassy_backup1.png :width: 60%