"Waiting for iCloud to synchronise Obsidian configuration files…" - very slow every time you switch to Obsidian on iPhone

Things I have tried

Almost every time I switch to the Obsidian on my iPhone (14 Pro) I see this message that prevents you from editing or even viewing your vault items.

I’ve tried creating new vaults, ensuring nothing else is syncing etc…

If it was a second or so it wouldn’t be an issue but can be quite a long time (10-30 seconds), additionally it’s not just after force closing the app - it’s whenever you switch back to the app after a few minutes, it’s as if the app doesn’t pause / suspend properly when in the background.

Some environmental information:

It doesn’t seem to matter which specific extensions are installed.

I use a lot of different apps with iCloud (Bear (Bear (even with a large, 8,000 note, 2GB library), iAWriter, Reeder, Things etc…) and none of them ever have syncing / storage performance issues.

My internet connection is quick (1000/50Mbit) with a good ISP, low latency, and has good peering.

iCloud syncs files / other applications documents as quickly my internet connection can go.


  • 2021 MacBook Pro M1 Pro
  • 2020 MacBook Air M1
  • iPhone 14 Pro

Happy to provide any helpful logs, run tests etc…

I’ve seen another thread asking the same question that never got any responses but I couldn’t reply to it as it was permanently closed.

What I’m trying to do

Use Obsidian on iOS with iCloud.

Side note: I am aware of Obsidian Sync. While I want to support development of software I wish to use - $150AUD/year for a single application syncing service is a lot of money (for me) and I’m not sure that Sync would realistically be any faster.

Because collaboration with Sync also requires each other person to also pay $150AUD/yr - it’s a big investment compared to iCloud which costs $54AUD/yr for everything.

My current thinking is that if I can get Obsidian to iCloud to work without the performance issues I’d rather drop a donation to the project - but I want to make sure it works well first.


This message will show up when files required for Obsidian’s operation need to be downloaded from iCloud.
Obsidian needs all files to be locally available on the device, so it forces iCloud to download these files.

How full is your phone storage?

Only Apple knows when and why it will unload a file from your device to save space.
This will happen more regularly when there is not that much space left on your device.


It’s set to download everything offline, I’ve only used 342GB of 512GB.

Is there any reason the app can’t launch with whatever it thinks is the latest data, then reload config if there are updates?

I’m assuming this is what other apps must do.


I didn’t think there was a way on iOS to make iCloud keep things downloaded.

Oh sorry you’re 100% correct - I was thinking of iCloud photos where there is that option.

What I’m going to do now is buy Obsidian Sync just for 1 month and compare it to using iCloud drive.

I’ll report back after some testing.


Well, almost two hours later it’s still syncing my 1.2GB vault… so far it seems Obsidian Sync is very slow compared to iCloud drive.

In fact - it looks like for the past two hours it’s only been uploading / creating directories:

2022-12-29 16:02 - Uploading _Bear/BearImages/81579925-3FD2-41EA-9948-4B837846C1CA-50511-0001BDCC22B8559C
2022-12-29 16:02 - Uploading _Bear/BearImages/815E24E8-7D52-4091-A85E-7C854D536523-50511-0001BDC8749C285C
2022-12-29 16:02 - Uploading _Bear/BearImages/815E514B-8E78-4171-872D-60D740C008CF-50511-0001BD8310326612
2022-12-29 16:02 - Uploading _Bear/BearImages/816379BA-0A83-4263-A517-EAA2EC99D4EA-50511-0001BDC4CE2EECA9
2022-12-29 16:02 - Uploading _Bear/BearImages/8167FCE7-004E-4469-9585-8B3077253EDE-50511-0001BDD5C76BC473
2022-12-29 16:03 - Uploading _Bear/BearImages/81685DD7-2D4F-43E4-A26F-F2828344EC0F-50511-0001BD847A1EC49C
2022-12-29 16:03 - Uploading _Bear/BearImages/8169FAB1-C488-4A99-81FD-BE3472A781B6-94459-0001E04BE47DC369
2022-12-29 16:03 - Uploading _Bear/BearImages/816A4C54-EC97-4656-93A3-A9782A11FBE9-50511-0001BDB39571C952
2022-12-29 16:03 - Uploading _Bear/BearImages/81706046-893D-4016-BC69-86D12A988F73-50511-0001BE15114A4AD2

Loading the sync’d vault on my phone only shows directories:

Sync eventually uploaded everything - took several hours though!

The app does start a lot faster than when it’s using iCloud Drive - but I have found it to be quite a bit slower at actually syncing / updating files.

iCloud is usually a second or two between machines, I’ve had Sync take a few minutes before files created on my alptop appear on my phone.

Interesting! I’ve found Sync to be pretty fast, and iCloud files occasionally get “stuck” (outside of Obsidian; I’ve never used iCloud with it). But my vault is smaller than 1.2 GB.

One thing to note is that on iOS, Obsidian Sync only works when Obsidian is open. So if you make a change and then immediately close Obsidian, the change might not sync until next time you open Obsidian.

1 Like

Why don’t they make it possible to use Dropbox? It syncs quickly and you have the option of keeping your vault offline which will hopefully prevent these issues. Like the OP, I find that even when working only on my iPad device, if I open another app and Obsidian is suspended for a moment it again struggles with this issue. At this point I essentially can’t use Obsidian on my iPad or iPhone.

One of the key reasons I use Obsidian is for its offline capabilities. On my recent flight I couldn’t even do that because it ran into this issue non-stop. I really hope a solution can be implemented soon.

1 Like

Dropbox doesn’t integrate fully with the iOS Files API. And if it did, that might still not be enough — as I understand it, Obsidian’s need to watch an entire folder for changes limits it to its own app folder on iOS.

How were you running into sync problems when you were offline?

Just as the OP described, every time I moved to another app for a moment and Obsidian became suspended it would again prompt the need to sync Obsidian configuration files (which never went out of sync being offline). That would either take awhile to happen or I just started skipping it, but then it would attempt to reindex my vault again. No matter how many times I let it sync the configuration files and index the vault, the moment I left the app for too long (often less than 5 mins), it would go through this same startup process. This happened while offline on a plane, or online in a coffee shop, anytime I’m on my mobile (iPhone 14) or table (iPad M1).

I’m sorry, I forgot this was a thread about iCloud and not Obsidian Sync. :see_no_evil:

Just wanted to throw my experience into the mix:

This seems to be some thing that has gotten worse on my iPhone. I can’t even use the Obsidian app now, it just sticks on that screen that says it’s waiting for iCloud to synchronize. The app worked seamlessly and I never saw that message in my first year of using it. Then suddenly about two months ago I started to see the synchronization message. It would usually linger for 10 to 15 seconds and then disappear and everything was fine. Now when I open the app it just sticks on that synchronization screen. I have not increase the number of or size of my vaults in this time, so I’m not sure what to do.

iPhone 13 Pro
2020 MacBook Pro
(Works fine on the laptop)


Also, if I tell the app to “skip” this process, I can open the app but then it freezes within a few seconds and I have to force quit it.



I have basically the same problem. For my usage (basic note taking), Obsidian is useless on iOS: it’s far too slow to open, and many times it freezes during synchronization and crashes - when I don’t have to restart it.


I started having the same issue today with Obsidian opening but not syncing configuration files and notes. Frustrated, I stayed up far past my bedtime (:laughing::yawning_face:) and happened to resolve the issue.

Sharing my post here in case my troubleshooting steps help anyone.

  1. Rename the new folder to what the problematic folder was previously named. For example, in this case, change the new folder to test.

This step isn’t needed because you already said to name the folder that way in step 2.

Also, would you mind posting a quick summary here?