You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardexpand all lines: content/SCALE/SCALETutorials/DataProtection/CloudSyncTasks/AddGooglePhotosCloudSyncTask.md
+16-8
Original file line number
Diff line number
Diff line change
@@ -11,16 +11,23 @@ keywords:
11
11
- data backup and recovery
12
12
---
13
13
14
-
Configuring a Google Photos cloud sync task requires a Google Photos API key and [rclone](https://rclone.org/) token.
15
-
See the [rclone Google Photos backend documentation](https://rclone.org/googlephotos/) for more on using rclone to sync Google Photos, including features and limitations of the Google Photos API.
14
+
Google Photos cloud sync tasks in TrueNAS SCALE use the [rclone](https://rclone.org/) backend for the [Google Photos API](https://developers.google.com/photos) to authenticate credentials and transfer data.
16
15
17
-
This is a multi-part procedure that includes [generating Google API credentials](#creating-the-api-credentials), [installing and configuring rclone](#configuring-rclone) on your client OS, [creating cloud credentials](#creating-google-photos-cloud-credentials) for Google Photos on TrueNAS SCALE, and then [configuring the cloud sync task](#creating-the-cloud-sync-task).
16
+
Configuring a Google Photos cloud sync task is a multi-part procedure that includes:
17
+
18
+
1.[Planning your deployment](#before-you-begin) and selecting a local dataset.
19
+
2.[Generating Google API credentials](#creating-the-api-credentials) on the Google Cloud API dashboard.
20
+
3.[Installing rclone and generating a token](#configuring-rclone) on your remote client OS.
21
+
4.[Adding Google Photos cloud credentials](#adding-google-photos-cloud-credentials) on TrueNAS SCALE.
22
+
5.[Configuring the cloud sync task](#creating-the-cloud-sync-task) on SCALE.
18
23
19
24
## Before You Begin
20
25
21
26
Review your storage and data protection requirements and consider your options before setting up a Google Photos cloud sync task.
27
+
Refer to the rclone Google Photos backend documentation for more information on using rclone to sync Google Photos, including [standard options](https://rclone.org/googlephotos/#standard-options) and [limitations of the Google Photos API](https://rclone.org/googlephotos/#limitations), that might help you plan your deployment.
28
+
22
29
Consider how you want to manage your media files on Google Photos and in your local dataset.
23
-
Select the cloud sync task direction, transfer mode, and remote folder to target that best fit your needs.
30
+
Select the cloud sync task [direction and transfer mode](#choosing-a-sync-direction-and-mode), [remote folder](#choosing-a-target-folder) to target, and [new or existing local dataset](#selecting-the-dataset-and-organizing-files) to pull to or push from, that best fit your needs.
24
31
25
32
### Choosing a Sync Direction and Mode
26
33
@@ -33,6 +40,7 @@ Choose to push data to Google Photos if you prefer to manage media files in the
33
40
34
41
Next, select the data transfer mode that best fits the way you want to manage file retention between the source and destination.
35
42
There are three options:
43
+
36
44
***SYNC** - Select to change files on the destination to match those on the source.
37
45
If a file does not exist on the source, it is also deleted from the destination.
38
46
***COPY** - Select to duplicate each source file into the destination.
@@ -55,9 +63,9 @@ A cloud sync task cannot target the root level folder (<file>/</file>).
55
63
| <file>/upload</file> |**No**| Push | Media files pushed from the local dataset to <file>/upload</file> are then uploaded to Google Photos and not sorted into an album. Because <file>/upload</file> is a temporary storage location, it can not accurately synchronize from one task to the next. Pushing to this folder does not preserve metadata and can result in duplicated files, poor performance, file name instability. |
56
64
{{< /truetable >}}
57
65
58
-
### Creating the Dataset and Organizing Files
66
+
### Selecting the Dataset and Organizing Files
59
67
60
-
Next, create a TrueNAS SCALE local dataset to use as the source or destination.
68
+
Next, select TrueNAS SCALE local dataset or create a new one to use as the source or destination.
61
69
62
70
{{< expand "Creating a Dataset" "v" >}}
63
71
{{< include file="/static/includes/CreateDatasetSCALE.md" >}}
@@ -152,9 +160,9 @@ Copy and save the type, client_id, client_secret, and token, then enter `y` to s
0 commit comments