iCloud and cloud storage

When iCloud will not download

Updated 2026-07-31 · 4 min read

A file with a cloud icon that ignores clicks is a sync pipeline problem, and the pipeline can be kicked.

Confirm the basics first

• Enough local disk? A nearly full disk halts downloads silently — check Storage settings
• Signed into the right Apple ID? System Settings → Apple ID
• iCloud status page green? Apple's System Status covers iCloud Drive outages, which are

not rare

Nudge the file

Right-click → Download Now. Opening the file also forces it. For a folder, select it and use Download Now on the whole thing.

The pipeline kick

The sync daemon is bird. Restarting it is safe and resolves most stuck states:

killall bird

It relaunches automatically and re-evaluates pending transfers. The heavier version:

killall bird cloudd

Then give it a few minutes — progress resumes quietly with no UI to say so.

Watch what it is doing

brctl log --wait --shorten

brctl is the iCloud Drive diagnostics tool; the log shows transfers as they happen and names the file it is stuck on, which is frequently one enormous or repeatedly-failing item blocking the queue behind it.

The nuclear sequence

Sign out of iCloud (System Settings → Apple ID → Sign Out, keeping local copies when asked), restart, sign back in. Re-syncing metadata for a large Drive takes hours; use it only when the pipeline kicks fail.

The structural note

Files in this state have real directory entries with no local content. Name search still finds them — content search cannot, since there is nothing local to read. Finding the stuck file by name and forcing it individually beats waiting for a queue.

Common questions

What is the bird process on macOS?

The iCloud Drive sync daemon. killall bird restarts it safely and often clears stuck transfers.

Why do iCloud downloads stall on a nearly full disk?

macOS refuses to fill the disk with downloads and pauses sync without much indication. Free space first.