Saving files into your iCloud Drive folder on macOS or Windows only to find the Finder status bar displaying “Uploading 1 item…”, “Waiting to upload”, or showing an incomplete pie progress icon that refuses to move for hours severs cloud file synchronization. In macOS, iCloud Drive synchronization is managed by a low-level background daemon called bird, which coordinates file metadata with Apple’s CloudKit servers through the cloudd daemon. When a specific file contains unreadable metadata attributes, when local sqlite synchronization journals become locked, or when network packets drop during chunk uploads, the bird daemon enters an unresponsive deadlock. This technical troubleshooting guide explains how Apple’s CloudKit synchronization engine operates and details step-by-step methods to unstick pending uploads on Mac and Windows.
Why Does iCloud Drive Get Stuck on ‘Uploading’?
iCloud Drive upload stalls usually indicate a transaction deadlock inside local file queues:
- Locked or Crashed bird Daemon: The macOS background process (
bird) responsible for processing local directory diffs crashes or deadlocks while attempting to calculate file checksums. - Corrupted CloudKit (cloudd) Cache Databases: The local metadata databases located in
~/Library/Caches/CloudKitcontaining damaged synchronization tokens. - Unsupported File Characters or Extended Attributes: Files containing illegal characters in their filenames (such as trailing spaces, colons, or specific Unicode glyphs) or zero-byte temporary lock files created by third-party software.
- Exhausted iCloud Storage Tier: If your iCloud storage plan (50GB, 200GB, or 2TB) is full, uploads pause silently without throwing an explicit user error.
- Network MTU or Corporate Proxy Interruption: Network connections with packet fragmentation issues stalling large chunk transfers.
Method 1: Force Terminate the ‘bird’ Daemon via Activity Monitor or Terminal
Terminating the bird process forces macOS to launch a fresh daemon instance and re-evaluate pending upload queues.
- Open Terminal via Spotlight (Command + Space) or Applications > Utilities.
- Execute the kill command for the bird process:
killall bird - Alternatively, open Activity Monitor, search for
birdin the top-right search box, select the process, and click the X (Stop) button > Force Quit. - The daemon will terminate and automatically relaunch within 3 seconds.
- Observe the iCloud Drive folder in Finder. The upload pie indicator will typically begin moving immediately as file chunking resumes.
Method 2: Isolate and Relocate the Problematic File
A single corrupted file stub or temporary cache lock can halt the entire upload queue.
- Open Finder and navigate to iCloud Drive.
- Change your Finder view to List View (Command + 2).
- Look down the list of folders and files for the iCloud status column (the cloud symbol).
- Identify which specific folder or file displays the dotted cloud or loading pie icon indicating an active upload.
- Drag that specific file or folder out of iCloud Drive and drop it onto your local Desktop.
- Observe Finder. If the remaining files immediately complete their upload, the issue was localized to that specific file.
- Inspect the file for unusual characters (remove slashes, colons, or trailing spaces) or duplicate extensions (e.g.
document.pdf.tmp), then drag it back into iCloud Drive.
Method 3: Clear Corrupted CloudKit Cache Files on macOS
Purging local CloudKit cache records forces the operating system to perform a clean resynchronization with Apple servers.
- Open Terminal.
- Navigate to your user CloudKit cache directory:
rm -rf ~/Library/Caches/CloudKit/* rm -rf ~/Library/Caches/com.apple.bird/* - Restart the bird daemon to apply changes:
killall bird - Allow macOS 2 to 3 minutes to reconcile its directory tree against Apple’s cloud servers.
Method 4: Toggle iCloud Drive in System Settings
Resetting the master iCloud Drive synchronization switch clears stubborn local configuration state files.
- Click the Apple menu () in the top-left corner and select System Settings.
- Click on your Apple Account / Name at the top of the left sidebar.
- Select iCloud in the right pane.
- Click on iCloud Drive.
- Toggle the switch for Sync this Mac to Off.
- When asked whether to keep a local copy of your files, select Keep a Copy (this archives files safely in an iCloud Drive (Archive) folder in your user directory).
- Wait 30 seconds, then toggle Sync this Mac back to On.
- iCloud Drive will reconnect cleanly and process pending file queues.
Method 5: Restart the iCloud Services on Windows
If you are experiencing upload stalls in the iCloud for Windows desktop app, restarting the underlying Windows services restores synchronization.
- Press Ctrl + Shift + Esc to launch Task Manager.
- Under the Processes tab, locate all tasks starting with iCloud (such as iCloud Drive, iCloud Services, and ApplePushService).
- Select each process and click End task.
- Press Windows Key + R, type
%localappdata%\Apple Inc\iCloudDrive, and press Enter. - Delete any temporary files ending in
.tmp. - Relaunch the iCloud app from your Windows Start menu to resume uploads.