iPhone syncing via iCloud and folder/vault structure

What I’m trying to do

Want to sync from Mac to iPhone via iCloud

Things I have tried

I don’t need multiple Vaults AFAIK at this point. The Mac app seemed happy having everything in iCloud/Obsidian/, but iOS app seems confused by this and treats each folder within as a Vault and ignores anything at the Obsidian folder level. So is it necessary to create something like this iCloud/Obsidian/Obsidian Vault-Main (which is synonymous with ~/Library/Mobile Documents/iCloud~md~obsidian/Documents/Obsidian Vault-Main/) to make the iOS app happy?
Just getting started with Obsidian.

Yes, if are doing it from the mac end. If you create an iCloud vault from iOS/iPadOS, it will be placed in that folder.

On macOS, you can keep your vault(s) pretty much anywhere, but if you want to use iCloud Drive on iOS/iPadOS, vaults (even if you are only using one) need to be in the iCloud Drive/Obsidian/ folder. iCloud/Obsidian/Obsidian Vault-Main as you suspected.


If you haven’t moved the vault yet, I would

  1. Open the Sandbox vault (Help > Sandbox vault) or a junk/test vault

  2. Close your main vault

  3. Using the Finder create an Obs-Vault-Main (or whatever) folder in iCloud Drive/Obsidian/

  4. Enable show hidden files/folders in the Finder

  5. Drag everything including the .obsidian settings folder inside /Obsidian/ into the new vault folder you created.

  6. Choose Manage vaults… from the Sandbox

  7. In the vault picker screen, Open folder as vault → Open and point the Finder at the new Obs-Vault-Main folder

Wait a bit for iCloud to sync and for your phone to see the changes. Oh, and right click / long press on the Obsidian folder and make sure it’s set to be Keep Downloaded on macOS and iOS. That should do it.

Thanks for this. It has been driving me nuts.