Pinning Files Offline
How Pinning Works
Unlike the standard cache system, pinned files exist in a separate storage space that isn't subject to cache size limitations or eviction rules. When you pin content, ShadeFS creates a complete local copy that persists until you explicitly unpin it. This means you can pin as much content as your local storage can accommodate, regardless of your configured cache size.
Working Offline
Pinned files remain fully accessible even offline. Any changes you make to pinned files while offline are marked as "dirty" in the system, indicating they need to be synchronized with the cloud. These files are protected from cache eviction until they can be successfully synchronized to ensure no work is lost when you come back online.
When reconnecting or restarting ShadeFS, the system automatically identifies any changed files and synchronizes them with the Shade cloud. Currently, in cases of conflicting changes between users, the most recent modification takes precedence as the source of truth.
Pinning Hierarchy
ShadeFS handles pinning with a hierarchy system. When working with nested folders:
Pinning a parent folder automatically includes all its contents
If both an outer folder and an inner folder are pinned, unpinning the inner folder won't have any effect as the outer folder's pin status takes precedence
You can selectively pin specific files or folders within an unpinned parent folder
Flexible Usage
A key advantage of ShadeFS pinning is its flexibility:
You can pin files without mounting the drive first
There's no limit to how much content you can pin (beyond your available storage)
Pinned status persists across system restarts and reconnections
You can continue to work with pinned files even when offline
Managing Pinned Content
To pin files or folders:
Open the Shade application
Navigate to the desired content
Right-click and select "Pin to Cache"
To unpin content:
Right-click the pinned item
Select "Unpin"
Last updated