iCloud Shared Folder Problems

iCloud allows sharing folders with other users, but sync errors can prevent updates from appearing, cause permission-denied messages, or make shared folders disappear. These issues typically stem from database sync conflicts between the folder owner and the guest account, or local directory permission errors.

This guide provides technical steps to repair local cloud database index tables, resolve NTFS permission conflicts, and re-establish shared folder paths on macOS and Windows.

---

1. Diagnose shared folder sync and permission errors

iCloud shared folder issues are usually caused by:

• Drift in Shared Database Index: iCloud uses a dedicated database to track shares. If your local client fails to sync this database, shared folders won’t show updates from other contributors.
• Local NTFS ACL Lockouts (Windows): File Explorer security permissions may block the local iCloud service from writing external users’ modifications.
• Expired or Revoked Invitation Tokens: The folder owner may have updated sharing settings, causing your guest token to be revoked.

---

2. macOS: Repair FileProvider domain database for shared files

On macOS, you can resolve sync errors by restarting the CloudDocs daemon and purging local databases.

Step 1: Force Restart the CloudDocs Daemon

1. Open Terminal.
2. Force-restart the sync daemon:

   killall bird

Step 2: Purge and Rebuild the Sync Database Cache

If updates in the shared folder do not sync:

1. Delete the local CloudDocs sync database (this forces Finder to re-download the folder structure and share states):

   rm -rf ~/Library/Application\ Support/CloudDocs

2. Restart the Finder process:

   killall Finder

Step 3: Verify FileProvider Domain Registration

1. Verify that the iCloud file provider domain is running:

   fileproviderctl domain sync com.apple.CloudDocs.MobileDocumentsFileProvider

---

3. Windows: Reset NTFS permissions on virtual shared directories

On Windows, you can reset permissions using the Command Prompt and clear local caches.

Step 1: Reset Permissions on the iCloud Drive Folder

If Windows displays permission errors when you edit shared files:

1. Open Command Prompt (Admin).
2. Reset NTFS permissions and inheritance on your iCloud folder:

   icacls "%USERPROFILE%\iCloudDrive" /reset /T

   (This ensures that the local iCloud client has the necessary permissions to read and write files modified by other users).

Step 2: Force Close and Clear Cache Databases

1. Force close the client:

   taskkill /f /im iCloudDrive.exe /im iCloudServices.exe

2. Clear the local app cache directory:

   rmdir /s /q "%LOCALAPPDATA%\Packages\AppleInc.iCloud_sr379ee5v9y2t\LocalState"

3. Restart iCloud from the Start Menu.

---

4. Re-authenticate and reset invitation states

• Re-Accept the Shared Folder Invitation: If a shared folder is completely missing, the guest token may have expired. Ask the owner to remove you from the share list and send a new invite link. Open the link to re-link the folder.
• Verify Sharing Options on iCloud Web: Log into iCloud Drive Web Portal and verify that you can see the shared folder online. If it is visible online but not on your desktop, focus on local client fixes.

---

5. Summary Checklist for iCloud Shared Folder Problems

Component / OS	macOS Fix Action	Windows Fix Action	Expected Outcome
Restart Sync	killall bird	taskkill /f /im iCloudDrive.exe	Restarts stalled shared folder sync tasks.
Purge Local Cache	rm -rf .../CloudDocs	Delete ...\LocalState folder	Re-syncs folder structures from Apple’s servers.
Folder Permissions	chmod -R 700 [SharedPath]	icacls ... /reset /T	Resolves permission-denied errors on local drives.
Sync Verification	fileproviderctl domain sync [domain]	N/A	Synchronizes local indices with cloud servers.
Web Check	Log into icloud.com web portal	Log into icloud.com web portal	Confirms folder sharing status and file contents.
Re-invite Guest	Re-request invite link from owner	Re-request invite link from owner	Re-authenticates guest access tokens.