The frustration is real. You take a photo, it shows the uploading indicator, and then nothing. Hours pass. Days pass. Your storage fills up locally because the files won't move to iCloud. But here's what we've learned: the problem is almost never your iPhone or Mac hardware. It's usually network configuration, iCloud cache corruption, or a sync queue that's simply jammed.
This guide covers what we see most often in our workshop, the terminal command that genuinely restarts the upload queue, and when you actually need to bring your device in for assessment.
Understanding Why iCloud Photos Upload Gets Stuck
iCloud Photos relies on three things working in harmony: a stable network connection, sufficient local storage, and a functioning sync daemon that talks to Apple's servers. When any one of these falters, the entire upload process stalls.
In Johannesburg, we see load shedding create this problem constantly. Your connection drops during upload. iCloud Photos tries to resume. The sync process crashes. The queue locks. On your phone, it looks like nothing's happening — but behind the scenes, the upload daemon has simply given up.
Library size matters more than most people realise. If you're uploading 50,000 photos for the first time, that's hundreds of gigabytes of data. On a weak network — which we see frequently in suburbs dealing with congestion or distance from cell towers — that process can take weeks. iCloud doesn't fail; it just stalls.
We've also found that old cached metadata causes genuine problems. iCloud Photos on your Mac caches information about what's already uploaded. If that cache becomes corrupted, the sync daemon thinks files are stuck when they're actually already in the cloud. It's maddening because everything looks broken when it isn't.
The Terminal Command That Restarts Your iCloud Photo Queue
On macOS, there's one reliable way to restart the iCloud Photos sync daemon and clear the jam. This works because it forces the system to rebuild its connection to Apple's servers and rescan your photo library.
Open Terminal and run this command:
What this does: it terminates the iCloud Photo Library sync process. macOS will automatically restart it within seconds. The daemon (called `bird`) will then re-read your photo library, check what's on Apple's servers, and restart the upload queue from where it actually left off — not where the corrupted cache thinks it left off.
We recommend waiting 30 seconds after running this command, then checking System Settings > iCloud > Photos to confirm the status. If uploads were genuinely stuck, you should see movement again.
Important: This only works on Mac. For iPhone and iPad, you'll need a different approach — which we cover below.
Fixing Stuck iCloud Photos on Your iPhone
iPhone doesn't give you terminal access, so you need to work with the settings that Apple provides. First, check your network. In our workshop, we've found that turning off WiFi and using mobile data (or vice versa) often clears the jam. iCloud sometimes gets confused about which network to use.
If that doesn't work, sign out of iCloud Photos temporarily. Go to Settings > [Your Name] > iCloud > Photos and toggle off "iCloud Photos." This doesn't delete anything — it just pauses sync. Wait 30 seconds. Turn it back on. Your iPhone will rebuild its sync connection and restart uploads.
If you're dealing with liquid damage that's caused intermittent network issues, that's a different problem requiring professional assessment. But for pure software stalls, this restart usually works.
Battery also matters. Make sure your iPhone is on a charger and plugged in during uploads. iCloud Photos throttles uploads on battery power to preserve battery life. Leave it charging overnight — you'll often find uploads have completed by morning.
We've also seen cases where iCloud Photos gets stuck because your device's clock is wrong. Go to Settings > General > Date & Time and make sure "Set Automatically" is on. A mismatched clock breaks encryption handshakes with Apple's servers.
Load Shedding, Network Quality, and iCloud Uploads in Johannesburg
This is specific to our city. Load shedding disconnects your internet. Your upload starts, the power drops, the connection cuts, and iCloud Photos tries to resume — but the queue is locked. This happens to almost every client in Johannesburg at least once.
The fix is to wait until you have stable power and network. Physically, if possible, move to a location with a strong WiFi signal and mains power — a coffee shop, office, or Sandton venue. Leave your phone plugged in. Let uploads run. Don't use your phone while uploads are happening.
If you have fibre (FTTH) in your area, use it. We've noticed that mobile data uploads are 40% more likely to stall during congestion hours. Fibre is more stable for large photo libraries.
For very large libraries (over 100GB), consider starting uploads late at night or early morning when network congestion is lower. We tell clients in Johannesburg: 23:00 to 06:00 is your friend for bulk uploads.
When to Seek Professional Help
Most stuck uploads you can fix yourself. But some indicate deeper issues. If you've cleared cache, restarted your device, and tried the terminal command on Mac — and uploads are still stuck after 48 hours — something else is wrong.
This could be a storage corruption issue, a problem with your iCloud account, or logic board damage affecting hardware communication with the network. We offer a R599 assessment at our Hyde Park workshop to diagnose exactly what's happening. From that assessment, most clients either fix the problem themselves (we show them how) or we handle it for you. We provide up to a 3-year warranty on iCloud-related diagnostics and repairs.
Contact us for an assessment, or WhatsApp us on 064 529 5863 if you want to describe the issue first.
When iCloud Photos Sync Actually Requires Hardware Repair
Some devices have genuine hardware issues that prevent uploads. We've seen failing WiFi modules, corrupted storage chips, and even logic board issues that break the device's ability to negotiate secure connections with Apple's servers. These aren't common — we see them in maybe 1 in 50 stuck upload cases — but they do happen.
If your device is old, has physical damage, or has been exposed to moisture, hardware could be your culprit. Liquid damage in particular can cause intermittent network problems that manifest as stuck uploads. Water-damaged boards show inconsistent WiFi performance: sometimes uploads work, sometimes they fail mysteriously.
We've repaired more than 22,000 devices with network-related issues across Johannesburg. The good news: most iCloud stuck uploads are software, not hardware. The bad news: if it is hardware, you need professional diagnosis.
Book online at zasupport.com/book for a same-day or next-day appointment at our Hyde Park location.
Frequently Asked Questions
Q: Will restarting my iPhone lose my photos?
No. iCloud Photos syncs your photos — restarting your device doesn't delete them. If they're already on iCloud, they remain there. If they're stuck uploading, restarting gives iCloud a fresh chance to upload them.
Q: How long should iCloud Photos take to upload?
On fibre with a new library: roughly 1GB per 5-10 minutes for the initial sync. A 50GB library might take 50-100 hours continuously. Load shedding, network congestion, and battery conservation all slow this down. In Johannesburg, plan for at least a week for large libraries.
Q: Does turning off iCloud Photos delete my photos from my device?
No. Turning off iCloud Photos keeps your photos on your device. They just won't sync to the cloud. Be careful: if you've enabled "Optimise Device Storage," your original files might be in the cloud only. Check before you disable iCloud Photos.
Q: Can I upload iCloud Photos over mobile data?
Yes, but it's slower and uses significant data. iCloud Photos will upload over 4G, but fibre WiFi is dramatically more reliable for large libraries.
Q: What if the terminal command doesn't work on my Mac?
Try restarting your Mac entirely. If uploads are still stuck after restart, sign out of iCloud and sign back in (System Settings > [Your Name] > iCloud > Sign Out, then sign back in). This resets the entire sync connection.
Q: Is stuck iCloud upload ever a sign of a serious hardware problem?
Rarely. We see it in under 2% of cases. Usually it's network or cache corruption. But if your device has physical damage, shows WiFi inconsistency, or is over five years old, have us assess it. Book online at zasupport.com/book or WhatsApp us on 064 529 5863.
