mirror of
https://github.com/Start9Labs/documentation.git
synced 2026-03-26 02:11:55 +00:00
60f83aa683
* change embassyOS to StartOS & nuance * Update conf.py * Update manifest.rst * say start9 instead of embassy in two links * progress * scrubbed faqs - basic-use, lightning, service-packaging, services, startos * add a few fixes * more * more 'embassy' cleanup * more * the last of embassy (aside from sdk and cli commands, links, etc) * some fixes * update icon, logo, and theme * Update site/source/user-manual/upgrade-hardware/upgrade-pro.rst * Update site/source/developer-docs/packaging.rst * Update site/source/developer-docs/specification/config-spec.rst * Update site/source/learn/concepts/networks.rst * Update site/source/learn/concepts/networks.rst * Update site/source/user-manual/customize.rst * Update site/source/support/faq/faq-basic-use.rst * Update site/source/user-manual/upgrade-hardware/naspi-upgrade.rst * Update site/source/user-manual/upgrade-hardware/upgrade-pro.rst * Update site/source/support/faq/faq-bitcoin.rst * Update site/source/support/faq/faq-bitcoin.rst * Update site/source/support/faq/faq-general.rst * Update site/source/support/faq/faq-general.rst * Update site/source/support/faq/faq-general.rst * Update site/source/support/faq/faq-general.rst * Update site/source/support/faq/faq-services.rst * Update site/source/support/faq/faq-general.rst * Update site/source/support/faq/faq-startos.rst * Update site/source/support/faq/faq-troubleshooting.rst * Update site/source/support/faq/faq-startos.rst * Minor fixes * Fix build errors, ready to roll * Add Beethoven * More fixes * More nother fix * More nother fixes agin * Remove sentence * cards instead --------- Co-authored-by: Matt Hill <matthewonthemoon@gmail.com> Co-authored-by: Shadowy Super Coder <musashidisciple@proton.me> Co-authored-by: Lucy Cifferello <12953208+elvece@users.noreply.github.com> Co-authored-by: kn0wmad <39687477+kn0wmad@users.noreply.github.com> Co-authored-by: agent <kn0wmad@protonmail.com>
160 lines
5.5 KiB
ReStructuredText
160 lines
5.5 KiB
ReStructuredText
.. _backup-mac:
|
|
|
|
==================
|
|
Mac Network Folder
|
|
==================
|
|
|
|
.. contents::
|
|
:depth: 2
|
|
:local:
|
|
|
|
Setup a Network Folder
|
|
----------------------
|
|
|
|
Please select what version of MacOS you are using from the two tabs below:
|
|
|
|
.. tabs::
|
|
|
|
.. group-tab:: Ventura
|
|
|
|
#. Identify or create a folder you would like to use to store your Start9 server's backups.
|
|
|
|
.. tip:: You can select an external drive or folder within an external drive connected to your Mac if you'd like.
|
|
|
|
#. Go to **System Settings**:
|
|
|
|
.. figure:: /_static/images/tor/systemSettings.png
|
|
:width: 40%
|
|
:alt: System settings
|
|
|
|
#. Click on **General** then **Sharing**:
|
|
|
|
.. figure:: /_static/images/cifs/ventura-general-sharing.png
|
|
:width: 40%
|
|
:alt: general-sharing
|
|
|
|
#. Click the toggle to enable file sharing:
|
|
|
|
.. figure:: /_static/images/cifs/ventura-enable-file-sharing.png
|
|
:width: 40%
|
|
:alt: enable-cifs
|
|
|
|
#. Click on the **"+"** icon and select the folder you would like to make backups to:
|
|
|
|
.. figure:: /_static/images/cifs/ventura-click-plus.png
|
|
:width: 40%
|
|
:alt: click-plus
|
|
|
|
#. Once added, click **Options**:
|
|
|
|
.. figure:: /_static/images/cifs/ventura-folder-added.png
|
|
:width: 40%
|
|
:alt: ventura-folder-added
|
|
|
|
#. Enable SMB sharing for the user you want to use and then click **Done**:
|
|
|
|
.. figure:: /_static/images/cifs/ventura-smb.png
|
|
:width: 40%
|
|
:alt: ventura-smb
|
|
|
|
You can now move on to connecting your server.
|
|
|
|
.. group-tab:: Pre-Ventura
|
|
|
|
#. Identify or create a folder you would like to use to store your Start9 server's backups.
|
|
|
|
.. tip:: You can select an external drive or folder within an external drive connected to your Mac if you'd like.
|
|
|
|
#. Go to **System Preferences** and click **Sharing**:
|
|
|
|
.. figure:: /_static/images/cifs/cifs-mac0.png
|
|
:width: 40%
|
|
:alt: sharing
|
|
|
|
#. Click **File Sharing**:
|
|
|
|
.. figure:: /_static/images/cifs/cifs-mac1.png
|
|
:width: 40%
|
|
:alt: file-sharing
|
|
|
|
#. Click the **"+"** icon under **Shared Folders** and add the folder you would like to back up to:
|
|
|
|
.. figure:: /_static/images/cifs/cifs-mac2.png
|
|
:width: 40%
|
|
:alt: click-plus
|
|
|
|
#. After selecting your folder, click **Options**:
|
|
|
|
.. figure:: /_static/images/cifs/cifs-mac3.png
|
|
:width: 40%
|
|
:alt: options
|
|
|
|
#. Enable **Share files and folders using SMB** and turn it on for the user you would like to use to authenticate and then click **Done**:
|
|
|
|
.. figure:: /_static/images/cifs/cifs-mac4.png
|
|
:width: 40%
|
|
:alt: SMB
|
|
|
|
#. Make a note of your computer's **Hostname** which can be found here:
|
|
|
|
.. figure:: /_static/images/cifs/cifs-mac-hostname.png
|
|
:width: 40%
|
|
:alt: hostname
|
|
|
|
#. You will also need the name of the "Shared Folder" you chose or created, as well as your Mac's username and password.
|
|
|
|
Connect Your Server
|
|
-------------------
|
|
|
|
#. Go to the **System** tab and click **Create Backup**:
|
|
|
|
.. figure:: /_static/images/config/backup.png
|
|
:width: 60%
|
|
:alt: system-create-backup
|
|
|
|
#. Click **Open New**:
|
|
|
|
.. figure:: /_static/images/config/backup0.png
|
|
:width: 60%
|
|
:alt: open-new
|
|
|
|
#. You will now see the following:
|
|
|
|
.. figure:: /_static/images/cifs/cifs-blank.png
|
|
:width: 50%
|
|
:alt: cifs-blank
|
|
|
|
Enter the credentials as follows:
|
|
|
|
* **Hostname** - This is the name of your computer.
|
|
|
|
.. tip:: Sometimes it can be unclear what your Mac's hostname is. One way to establish it for good is to open up Terminal and type `hostname` as below:
|
|
|
|
.. figure:: /_static/images/cifs/hostname-terminal-mac.png
|
|
:width: 35%
|
|
:alt: hostname-terminal-mac
|
|
|
|
In Pre-Ventura versions of MacOS it can be found in the **Sharing** settings mentioned above (step 7).
|
|
|
|
* **Path** - This is the *name of the shared folder* you are using and **not** the full directory path.
|
|
|
|
.. tip:: If you copied the share name from the Mac computer and it contained a space, macOS will have replaced the space with the string "%20". Please re-replace `%20` with a space in this `Path` field.
|
|
|
|
* **Username** - This is the user on the remote machine that you used to create the shared directory.
|
|
* **Password** - This is the password to the above user.
|
|
|
|
.. figure:: /_static/images/cifs/cifs-mac5.png
|
|
:width: 60%
|
|
|
|
.. note:: If you are on MacOS Catalina (version 10.15.7), and the backup fails, please `see this Apple support thread <https://discussions.apple.com/thread/253970425>`_. If the provided solution still doesn't work, SMB file sharing probably will not work for this old Mac. Consider backing up to a USB thumb drive instead.
|
|
|
|
.. note:: If you recently updated to MacOS Ventura (version 13.2), and you cannot get the share to connect:
|
|
|
|
#. Turn off file sharing switch in **General > Sharing**
|
|
#. Restart macOS
|
|
#. Turn on file sharing switch in **General > Sharing**
|
|
|
|
#. Click **Connect**.
|
|
|
|
That's it! You can now :ref:`create encrypted, private backups<backup-create>` of all your Start9 server's data to your Mac.
|