Skip to content
Merged
Changes from 1 commit
Commits
Show all changes
53 commits
Select commit Hold shift + click to select a range
71f1e7a
Spotlight is supported for _Integrated_ connect mode.
dkocher Oct 9, 2022
3e90446
Dragging files will move by default in Finder in _Integrated_ connect…
dkocher Oct 9, 2022
9153bcd
Custom mount not supported in _Integrated_ connect mode.
dkocher Oct 9, 2022
8fbaa55
Custom cache location not supported in _Integrated_ connect mode.
dkocher Oct 9, 2022
ba60974
Add note about OS cache management.
dkocher Oct 9, 2022
e916401
Pseudo locking not supported.
dkocher Oct 9, 2022
3f990f8
Add _Integrated_ mode.
dkocher Oct 9, 2022
aeb4716
Add but always in `~/Library/CloudStorage`
dkocher Oct 17, 2022
114f496
Add additional icons shown in Finder with file provider.
dkocher Oct 28, 2022
6e4c3e9
Add note that opening files from history in applications may fail bec…
dkocher Oct 28, 2022
e950722
New system requirements.
dkocher Oct 28, 2022
3d25287
Add page for _Integrated_ mode.
dkocher Jul 12, 2023
025a3b5
Invert images.
dkocher Jul 12, 2023
33fa897
Add Integrated connect mode to table.
dkocher Oct 25, 2023
24de8bd
Remove not not applicable.
dkocher Nov 30, 2023
b9663fa
Add links to pages.
dkocher Nov 30, 2023
552c72c
Change to headings.
dkocher Nov 30, 2023
593b10e
Revise sync status documentation with additional file provider icons.
dkocher Nov 30, 2023
51c98d2
Optional Driver Installation
dkocher Nov 30, 2023
c5e5a79
Review
Cassie205 Jan 30, 2024
e76e096
Add Limitations
Cassie205 Jan 30, 2024
4a4ccff
Issue #458
Cassie205 Jan 30, 2024
db799d6
Add "Network Volume"
dkocher Feb 12, 2024
0bd947f
QuickLook requires offline file.
dkocher Oct 9, 2022
ba52ac8
Add note about OS cache management.
dkocher Oct 9, 2022
cd7d56c
Review
Cassie205 Jan 30, 2024
526b287
Add info for custom versioning Mountain Duck
Cassie205 Jun 28, 2024
ffd907a
Review
dkocher Sep 27, 2024
db9919c
Review
dkocher Sep 27, 2024
c7bfb54
Formatting
dkocher Sep 27, 2024
e0ddec6
Checkmark for indexer.
dkocher Dec 28, 2024
393e2fa
Update system requirements.
dkocher Feb 2, 2025
35bbfeb
Review.
dkocher Feb 2, 2025
49c0fb7
Review.
dkocher Feb 2, 2025
efd2475
Add minimum version.
dkocher Feb 2, 2025
db81524
Formatting.
dkocher Feb 7, 2025
c33532e
Formatting.
dkocher Feb 7, 2025
1525f26
Formatting.
dkocher Feb 8, 2025
dfbc22d
Formatting.
dkocher Feb 8, 2025
1e7213d
Fix description.
dkocher Feb 8, 2025
4f96c50
Fix typo.
dkocher Jul 14, 2025
63180db
Update system requirements.
dkocher Jul 14, 2025
fcdd35a
Add beta label.
dkocher Jul 14, 2025
8753c22
Updated screenshot.
dkocher Jul 14, 2025
ba4cbda
Add Integrated.
dkocher Jul 14, 2025
7501eb3
Merge sections.
dkocher Jul 14, 2025
d7afef0
Add activity window.
dkocher Jul 14, 2025
23e037e
Remove duplicate content.
dkocher Jul 14, 2025
5f4868a
Remove duplicate content.
dkocher Jul 14, 2025
7dc7a4b
Formatting.
dkocher Jul 14, 2025
09fbe24
Set title to Integrated Connect Mode.
dkocher Jul 14, 2025
5399835
Review.
dkocher Jul 14, 2025
b890f68
Review.
dkocher Jul 14, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
Formatting
  • Loading branch information
dkocher committed Jul 14, 2025
commit c7bfb54f3e10f7fe35b66abe5795d7ecd5543a3e
52 changes: 26 additions & 26 deletions mountainduck/connect/integrated.md
Original file line number Diff line number Diff line change
@@ -1,21 +1,21 @@
Integrated
====

```{toctree}
:::{toctree}
:hidden:
:titlesonly:
```
:::

```{image} ../_images/Disk_Syncing.png
:::{image} ../_images/Disk_Syncing.png
:alt: Disk Syncing
:width: 200px
```
:::

> Local storage is managed by the operating system. The mount is not seen as a remote volume by applications but as a regular folder on disk. This option uses the tightly integrated _File Provider_ (macOS) and _Cloud Files_ (Windows) APIs. Directories can be browsed when offline and files opened are made available for later offline access. You can choose to make selected files and folders available for offline use. Changes to files are uploaded in the background as soon as a connection is available.

```{tip}
:::{tip}
You can access files in _Integrated_ connect mode without being always connected the server or cloud storage.
```
:::


## Status of Files
Expand All @@ -25,29 +25,29 @@ Files and folders on a mounted volume have a status icon overlay in _File Explor
### ![](../_images/overlay_uptodate.png) Up to Date
The file or the contents of a directory has been opened and downloaded to your computer and therefore currently synced with the server or cloud storage. The file takes disk space on your computer and can always be opened even when no connection to the server or cloud storage is possible. New files in a directory on the remote server will appear as *Online Only* and are not downloaded automatically. Files copied to a volume are kept cached by default.

```{note}
:::{note}
Files can be purged automatically from the cache when not accessed or the cache size limit is exceeded. Refer to [Cache Limitations](../preferences.md#cache-limitations).
```
:::

### ![](../_images/overlay_infinite.png) Online Only
The file can only be opened when a connection to the server or cloud storage can be made. The file does not take any space on your computer. The file is downloaded on demand when you open it.

:::{admonition} macOS only
:class: note
```{image} ../_images/File_Provider_Online_Only.png
:::{image} ../_images/File_Provider_Online_Only.png
:alt: File Provider Icon
:width: 24px
:align: left
```
:::
Click this additional icon displayed next to the filename in Finder.app to request the download of the file.
:::

### ![](../_images/overlay_sync.png) In Sync
The file or folder is selected to be synced with the server or cloud storage to always keep offline. The file takes disk space on your computer and can always be opened even when no connection to the server or cloud storage is possible. New files in a directory on the remote server will be downloaded automatically.

```{tip}
:::{tip}
Files explicitly selected to keep offline are **not** automatically purged. Refer to [Cache Limitations](../preferences.md#cache-limitations).
```
:::

### ![](../_images/overlay_syncing.png) Sync in Progress
The file or folder is currently syncing with the server or cloud storage. Check the menu with the sync status for current download or upload progress.
Expand All @@ -61,11 +61,11 @@ Files that failed to sync after changes. You are missing permission to write to

:::{admonition} macOS only
:class: note
```{image} ../_images/File_Provider_Ignored.png
:::{image} ../_images/File_Provider_Ignored.png
:alt: File Provider Icon
:width: 24px
:align: left
```
:::
This additional icon displayed next to the filename in Finder.app indicates the file is not synced.
:::

Expand All @@ -77,11 +77,11 @@ The file or folder is only saved in local cache and not synced. New _Folders_, e

:::{admonition} macOS only
:class: note
```{image} ../_images/File_Provider_Error.png
:::{image} ../_images/File_Provider_Error.png
:alt: File Provider Icon
:width: 24px
:align: left
```
:::
This additional icon displayed next to the filename in Finder.app indicates a sync error for the file.
:::

Expand All @@ -90,10 +90,10 @@ This additional icon displayed next to the filename in Finder.app indicates a sy

Changes to files are uploaded in the background as soon as a connection is available. Progress is reported by animating the status bar icon and a menu item titled *Sync in Progress*.

```{admonition} macOS only
:::{admonition} macOS only
:class: tip
Progress is shown when downloading or uploading a file with a progress bar over the file icon or circular progress indicator adjacent the filename.
```
:::

### Keep Offline

Expand All @@ -102,11 +102,11 @@ Choose *Mountain Duck → Keep Offline on Local Disk* to make files and folders
:::{admonition} macOS only
:class: tip

```{image} ../_images/File_Provider_Online_Only.png
:::{image} ../_images/File_Provider_Online_Only.png
:alt: File Provider Icon
:width: 24px
:align: left
```
:::
_Download Now_ when using _Integrated_ connect mode downloads the file but allows it to be removed from cache on low disk space.
:::

Expand All @@ -115,26 +115,26 @@ _Download Now_ when using _Integrated_ connect mode downloads the file but allow

Choose *Mountain Duck → Delete on Local Disk* to delete the offline copy. The status of the file will change to *Online Only*. The action is recursive for all contained files when a folder is selected and allows you to quickly free up space used in the cache on your local disk.

```{admonition} macOS only
:::{admonition} macOS only
:class: tip

Choose _Remove Download_ instead when using _Integrated_ connect mode.
```
:::

## Cache

There are different ways to delete the sync cache:
* Delete the bookmark with connection mode set to *Smart Synchronization* or *Integrated*
* Use the deletion prompt when switching the connect mode between *Integrated* and *Smart Synchronization*
```{image} ../_images/Prompt_Delete_Cache.png
:::{image} ../_images/Prompt_Delete_Cache.png
:alt: Delete Cache Prompt
:width: 400px
```
:::
* Use the delete option in Finder.app once the bookmark is disconnected. You will be prompt to confirm the deletion as it can lead to file loss if some changes aren't synchronized to the server
```{image} ../_images/Finder_Option_Delete_Cache.png
:::{image} ../_images/Finder_Option_Delete_Cache.png
:alt: Delete Cache Option
:width: 800px
```
:::

## Limitations

Expand Down