Start9/documentation
2
0
Fork 0
mirror of https://github.com/Start9Labs/documentation.git synced 2026-03-26 10:21:53 +00:00
Code Issues Packages Projects Releases Wiki Activity

Touchups to Linux Samba-share instructions (#138)

Browse Source 
* Touchups to Linux Samba-share instructions

* Added quotes around path in smb.conf (necessary if any spaces are used in a folder name)

* Moved Ubuntu into Ubuntu section under video, below Ubuntu/Other Linux tabs so they can be more visually prominent

* Add note admonition about Ubuntu vs Other Linux

* add linebreak

* Updated screenshot for network share entry & added Path hint

* Updated path hint quotation
This commit is contained in:
gStart9
2022-06-30 22:16:39 +00:00
committed by GitHub
parent 517dca20a2
commit c2a2a8a093
3 changed files with 33 additions and 27 deletions
Download Patch File Download Diff File Expand all files Collapse all files

BIN
site/source/_static/images/config/embassy_backup1.png
View File

Binary file not shown.
Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 96 KiB

After

Width:  |  Height:  |  Size: 29 KiB

42
site/source/user-manual/backups/backup-setup/backup-linux.rst
View File

@@ -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
<br/><br/>
#. 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%