iCloud Drive on my Mac (10.13.3) won't sync.

  • My other devices perform perfectly, as does icloud.com. Any change made on one immediately propagates to the others.
  • Changes made to iCloud Drive on my Mac go nowhere. The cloud icon displays indefinitely. Changes aren't propagated to my other devices or iCloud.com, nor do changes made in other locations propagate to my Mac, which is lost in some orphan universe of its own.
  • All other services (i.e., Contacts, Calendar, etc.) perform perfectly.

So far I've tried…

  • Disabling/enabling iCloud Drive on all my devices.
  • Various combinations of disabling/enabling "Desktop & Documents Folders"
  • Signing out/in of iCloud on all my devices.
  • Restarting the Mac until the startup chime had me reciting Edgar Allan Poe's "The Bells."
  • Removing all files and experimenting with one small file.
  • Waiting eight hours for a 25kb startled cat photo to sync.

…all to no avail.

I've attached log entries matching…

message type:error
message type:fault

…below, but if there are obvious screaming errors in it, they're over my head.

I'm at wit's end. Suggestions would be most appreciated.

iCloudPreferences   error   15:45:50.464165 -0800   com.apple.preferences.icloud.remoteservice  [AOSAccounts] : ****###****-[MMMobileDocumentsService confirmUserWantsToDisableiCloudDriveAndDesktopWithDialogCompletion:] kMMPropertyMobileDocumentsiCloudDriveDisableDataclassActions  returned  (null)  uploadPending 1 downloadPending 1
iCloudPreferences   error   15:45:52.377211 -0800   com.apple.preferences.icloud.remoteservice  [AOSAccounts] :  -[MMMobileDocumentsService observeValueForKeyPath:ofObject:change:context:]: progressText got from iCloud Drive :()
iCloudPreferences   error   15:45:52.377322 -0800   com.apple.preferences.icloud.remoteservice  [AOSAccounts] :   ****###****     -[MMMobileDocumentsService observeValueForKeyPath:ofObject:change:context:]:                                                 0.0% [indeterminate]            (fractionCompleted)
iCloudPreferences   error   15:45:58.012621 -0800   com.apple.preferences.icloud.remoteservice  [AOSAccounts] : [-[MMMobileDocumentsService setEnabled:creating:withWindow:]_block_invoke_2] : showUploadDisableiCloudDriveSheetWithCompletionHandler completed with status 1
iCloudPreferences   error   15:45:58.015098 -0800   com.apple.preferences.icloud.remoteservice  [AOSAccounts] : [-[MMMobileDocumentsService uploadAndOptOutOfiCloudDriveWithCompletionHandler:]_block_invoke] : BRUploadAllFilesForLogOutOperation completed with error Error Domain=NSCocoaErrorDomain Code=3072 "The operation was cancelled."
iCloudPreferences   error   15:45:58.015652 -0800   com.apple.preferences.icloud.remoteservice  [AOSAccounts] : [-[MMMobileDocumentsService handleOperationCompletion:]] : BRUploadAllFilesForLogOutOperation  or BRDownloadAllFilesForLogOutOperation completed with error Error Domain=NSCocoaErrorDomain Code=3072 "The operation was cancelled."
iCloudPreferences   error   15:45:58.016112 -0800   com.apple.preferences.icloud.remoteservice  [AOSAccounts] : [-[MMMobileDocumentsService handleOperationCompletion:]] : BRUploadAllFilesForLogOutOperation  or BRDownloadAllFilesForLogOutOperation failed with error Error Domain=NSCocoaErrorDomain Code=3072 "The operation was cancelled."
iCloudPreferences   error   15:45:58.029026 -0800   com.apple.preferences.icloud.remoteservice  [AOSAccounts] : SetEnabledOnACAccount_block_invoke Dataclass Action sent to save account robertbryanharrison@mac.com  service com.apple.Dataclass.Ubiquity enableState 0 : {
    "com.apple.Dataclass.Ubiquity" = ACDataclassActionMergeLocalDataIntoSyncData;
iCloudPreferences   error   15:47:05.448533 -0800   com.apple.preferences.icloud.remoteservice  [AOSAccounts] :  [GetProperty]  kMMPropertyMobileDocumentsMigrationStatusKey status: <CFBasicHash 0x61000066b300 [0x7fff99f38980]>{type = mutable dict, count = 3,
entries =>
0 : status = SUCCEEDED
3 : id = <CFString 0x61000046d540 [0x7fff99f38980]>{contents = "edac53f1-93db-48ac-b9f3-2512550632a7"}
11 : name = <CFString 0x610000233440 [0x7fff99f38980]>{contents = "NOT_NEEDED"}

I had the same problem. I tried restarting, new user profiles, signing in and out of iCloud, check and unchecking documents in the cloud etc.

Each time I waited several hours, but my iCloud documents did not appear.

What finally worked was Dwight McKay's suggestion:

In the Mac Terminal program (in the Utilities folder), type:

killall bird
cd ~/Library/Application\ Support
rm -rf CloudDocs

then immediately restart the computer. iCloud syncing will begin automatically.

I had to wait about an hour for file names to show up, and of course the actual files are still in the cloud.

It is too technical for me but you can paste the following line into the Terminal to follow sync progress

brctl log -w

It took about 4 hours to go through 300 gb. brctl stopped output when it was done.

You can find more information at Dwight's page:

  • bird is the daemon that syncs iCloud documents

  • ~/Library/Application Support/CloudDocs contains the iCloud meta-data store

| improve this answer | |
  • Hi, I have the same issue. Could you say a few more words for the code that I should type in Terminal? Is that Killall bird, 'enter', and then cd ~/Library/Application\ "space" Support, "enter" and then rm -rf CloudDocs? I cannot get the code right so I tried to find CloudDocs in Library/Application Support but I cannot find that, either. Thanks. – Chris Kuo Sep 12 '18 at 23:41
  • 1
    Yes, type enter after each line. The second line can also be written cd ~/Library/"Application Support" (the \ makes sure that the following space & Support are included in the directory name). It might work to do all this in the Finder: cmd-shift-g then "~/Library/Application Support" then drag CloudDocs to the trash. Then open the trash and control-click on CloudDocs and delete immediately. If you can't find CloudDocs at all, can you tell me what version of Mac OS you are on? (Apple Menu › About This Mac). – Andrew Swift Sep 13 '18 at 7:57
  • 2
    Related to the question by @ChrisKuo. A general word of caution would probably be in place here. rm -rf is a powerful command that can do a lot of harm on your computer. Please make sure you know what you are doing. Generally it is not advisable to copy&paste commands from websites. – n1000 Mar 8 '19 at 13:48
  • 2
    After doing a fresh Catalina installation, I had the exact same problem. I don't know if this technique resolved my issue because even after applying it, my files were still missing and appeared randomly couple of hours later. – Can Sürmeli Oct 9 '19 at 9:06
  • 1
    I had the same problem after a Catalina installation and migration. I had errors in Console for mdworker "System Policy: deny(1) on the Mail Library.". I had to remove iBooksAuthor.mdimporter from Library/Spotlight and then follow the steps described in this answer. – intagli Nov 12 '19 at 16:47

After months dealing with this issue I finally have a fix that makes sense. It's possible to create filenames with emojis on an iOS device that iCloud Drive on Mac doesn't know how to handle. If iCloud Drive is syncing across your iOS devices but not macs, try this:

On an iOS device, rename or delete suspicious filenames to remove emojis and unicode characters.

In my case I went nuclear and tried to delete them all from my iPad (after backing them up by copying them to On My iPad). Here's the problem with that, they're still in Recently Deleted and Macs still don't like it. You need to navigate to Locations -> Recently Deleted and tap Select and then Delete All at the bottom.

Afterwards do the sacred ritual we've all done tens of times:

  • Disable iCloud Drive in Preferences -> iCloud
  • In a terminal killall bird; rm -rf ~/Library/Application\ Support/CloudDocs; rm -rf ~/Library/Caches/com.apple.bird
  • Reboot the computer
  • Enable iCloud Drive in Preferences
  • Cry real tears of joy
| improve this answer | |
  • 2
    Warning: make a copy of your files before doing this. ~/Library/Caches/com.apple.bird may store files that you have modified that aren't in sync with iCloud Drive and which don't exist anywhere else. If you follow these steps because of a sync issue without making a copy of your local changes first, data loss may result. – bjb568 Sep 19 '19 at 17:30

I wrote a script. Uses sudo... so use CAUTION!


if [[ $EUID -eq 0 ]]; then
    echo "Killing bird."
    killall bird
    echo "Removing CloudDocs"
    cd ~/Library/Application\ Support
    rm -rf CloudDocs
    echo "Immediately rebooting!"
    shutdown -r now
    echo "
    This script needs run as sudo. 
    Use CAUTION when doing so.
    You accept full responsibility using this script.
    You should know what it's doing BEFORE you run it.

Restarts automatically immediately after.

| improve this answer | |

I use iCloud Drive to sync between my iMac, MacBook Pro, and iPhone, which has always worked quite well, but I encountered the same problem after restoring some files to my iMac from Time Machine.

I tried everything the OP tried and eventually deleted CloudDocs as suggested, as well as the com.apple.bird cache directory, but syncing remained stalled over the course of days.

My eventual solution, after verifying that my system backups were current, was to disable iCloud Drive (Settings --> iCloud) on my iMac and MacBook and then use my iPhone to “Delete Documents & Data” from iCloud Drive:

If you get a dialogue box that says that iCloud Drive must finish syncing before you can continue, it is safe to click the option to continue without finishing, assuming all of your files are stored on your local machine. If you have important files that exist only in the cloud, this is probably not the solution for you in any case.

Settings → Apple ID (tap your picture) → iCloud → Manage Storage → iCloud Drive → Delete Documents & Data

The nice thing is that this leaves Photos, Messages, Mail, etc. alone.

After verifying at iCloud.com that my iCloud Drive was empty, I re-enabled iCloud Drive on my iMac. It began syncing immediately and completed without any problem. After that, I re-enabled iCloud Drive on my MacBook and everything began downloading.

In my case, my iMac is kind of the “master” system. So this fresh start with iCloud Drive was the perfect solution. The various iCloud Drive-related caches on my Mac are a bit smaller now too.

| improve this answer | |

Thank you. My solution proved a bit different, and as I don't fully understand it, I didn't post it.

My problem related to the system in question's multiple network interfaces - specifically, two active ethernet connections. A combination of deleting/recreating the interfaces and the update to macOS 10.13.2 left iCloud functioning correctly, but as I said, I don't really know why. I'm only clear that some problem with multiple network connections was at the root of it.

| improve this answer | |

I had a similar issue to Brian's below -- earlier in the day I had been using iPhone USB for my network, and when I switched to Wifi later on, iCloud would not sync. I turned on my VPN and it started syncing instantly. Switching network connections seems to create the problem but also resolve it.

| improve this answer | |

You must log in to answer this question.

Not the answer you're looking for? Browse other questions tagged .