← Back to case log

I Tried to Build a Free Obsidian Sync Setup Across Mac, Android, and iPhone — Here's What Actually Happened

17 AUG 2026 CONFIRMED
REVERSE ENGINEERED

I wanted one Obsidian vault on three devices without paying for another subscription. Syncthing looked like the obvious answer. Then iOS got involved.

The plan sounded ridiculously simple

I use Obsidian because I like the idea that my notes are just files. No proprietary database, no mysterious cloud-only format, no feeling that my notes are trapped inside an app. So when I decided I wanted the same vault on a Mac, an Android phone, and an iPhone, I assumed the solution would be straightforward.

There were two obvious choices. Pay for Obsidian Sync and let Obsidian handle everything, or find a way to synchronize the underlying files myself.

I chose the second option.

That led me to Syncthing.

On paper, Syncthing is almost exactly what I wanted. It doesn't care whether a file is a Markdown note, an image, a PDF, or something else. It simply keeps folders synchronized between devices. No monthly storage plan. No proprietary cloud vault. Just files moving between machines.

What I didn't appreciate at first was that Mac, Android, and iOS do not play by the same filesystem rules.

Mac was easy. Android was easy. Then came the iPhone.

The Mac was the natural starting point because the Obsidian vault already existed there. I added the vault to Syncthing and gave it a folder ID. The Android device was then paired with the Mac and the vault was shared.

And it worked.

Folders appeared. Notes appeared. The Android side became the first proof that the basic Syncthing configuration was sound.

At that point, I thought the iPhone would be a five-minute job.

It wasn't.

The iOS filesystem is where the fun begins

On desktop operating systems, it is easy to think of a folder as a folder. On iOS, applications operate inside a much more controlled filesystem environment. Obsidian cannot simply wander into another app's storage and declare, “Yep, that's my vault now.”

So the trick was to give Obsidian a folder it could actually see, while simultaneously making Syncthing use that folder as the local destination for the synchronized vault.

The workaround was surprisingly elegant once the pieces clicked.

I created an empty vault in Obsidian on the iPhone and chose to continue without Obsidian Sync. That created an Obsidian-owned folder on the iPhone.

Then, instead of creating a brand-new Syncthing relationship, I connected the existing synchronized folder to that Obsidian folder.

In other words, the same Syncthing folder identity that represented the vault on the Mac was mapped to a location Obsidian could access on iOS.

Mac
└── Obsidian Vault
        │
        │ Syncthing
        ▼
iPhone
└── Obsidian
    └── Temporary Vault
            │
            └── Obsidian sees the files

That was the breakthrough.

Then Syncthing showed me files I hadn't actually downloaded

This was another little trap.

Syncthing could show the vault's folders and files on the iPhone, but that didn't automatically mean every item was being kept locally. Some content needed to be explicitly synchronized with the device.

Once the vault folders were selected for local synchronization, they began appearing inside the Obsidian folder on the iPhone.

Seeing a file in Syncthing isn't necessarily the same thing as having that file stored locally where Obsidian can use it.

The test file that sent me down the wrong path

Of course, I needed a test.

I initially created an RTF file and watched it appear in Syncthing. That proved the file was being transferred, but it wasn't actually a great Obsidian test.

So I switched tactics.

I opened the vault in Obsidian on the Mac, went into the inbox folder, and created a real Markdown note:

Sync Test.md

I put a simple sentence inside it and waited.

Then I opened Obsidian on the iPhone.

There it was.

Sync Test.

That was the moment I knew the setup wasn't just theoretically working. The actual Obsidian workflow was working.

Then, naturally, it disconnected

Because apparently the setup wasn't allowed to end on a high note.

The iPhone eventually showed the Syncthing device as disconnected, while the Android device continued syncing normally.

That was actually useful diagnostically.

The Mac vault was fine. The Syncthing folder was fine. Android proved that synchronization itself was working. The problem was isolated to the iPhone connection.

The usual suspects were checked: the iPhone and Mac were on the same Wi-Fi network, and the iOS app had Local Network permission enabled.

Eventually the iPhone reconnected.

Green status.

Back in business.

And then came the “extra files” warning

Syncthing wasn't finished making me nervous.

It reported that the vault had extra files on the iPhone. The warning looked dramatic until the list was opened.

The culprit was an Obsidian workspace conflict file inside .obsidian.

Not a missing note. Not a broken vault. Not the end of civilization.

Just an Obsidian-generated workspace conflict file.

It was removed, the folder returned to a connected state, and the actual Markdown files remained intact.

This was another useful lesson: never react to a sync warning before looking at the files it is actually talking about.

The final test was almost anticlimactic

After all that, the final verification was wonderfully boring.

The iPhone was connected.

The synchronized folders were present.

Obsidian on the iPhone could open the vault.

And the Sync Test note appeared exactly where it was supposed to.

                 Syncthing
                    │
          ┌─────────┼─────────┐
          │         │         │
          ▼         ▼         ▼
         Mac      Android   iPhone
          │         │         │
      Obsidian   Obsidian  Obsidian
        Vault      Vault     Vault

The important part is that Syncthing isn't an Obsidian service. It is simply synchronizing the files that make up the vault.

So, is this actually better than Obsidian Sync?

That depends entirely on what you want.

Obsidian Sync is the polished answer. It is built specifically for Obsidian and removes most of the setup work. If you want something that just works and you're happy paying for it, there's a strong argument for using it.

Syncthing is the tinker's answer.

You configure the devices yourself. You understand where the files live. You deal with connections, folder selection, conflicts, and the quirks of each operating system.

But in return, there is no Syncthing subscription and no cloud storage quota imposed by Syncthing itself. Your practical storage limit is the free space on your devices.

That makes it particularly attractive for people who like the philosophy behind Obsidian in the first place: your notes are files, so why not synchronize the files?

There is one thing Syncthing absolutely isn't

It isn't a backup.

This distinction is easy to miss.

If you delete a note and that deletion synchronizes across your devices, you haven't created a backup system. You've created a synchronized deletion.

For anything important, keep an independent backup as well. Syncthing handles synchronization; your backup strategy handles recovery.

The setup I'd recommend after going through all of this

  1. Keep your existing Obsidian vault on the Mac.
  2. Add that vault to Syncthing.
  3. Pair the Android device and share the vault.
  4. Create an empty Obsidian vault on iOS without enabling Obsidian Sync.
  5. Use Syncthing's existing-folder approach to map the synchronized vault into the Obsidian-accessible folder on iOS.
  6. Make sure the vault contents are actually being kept locally on the iPhone.
  7. Verify the Syncthing device connection.
  8. Test with a real .md note.
  9. Test synchronization in both directions.
  10. Keep a separate backup.

The verdict

Would I recommend this to everyone?

No.

If you want zero configuration and don't care about paying for synchronization, Obsidian Sync is the easier answer.

But if you like owning your files, already have multiple devices, and don't mind spending an evening figuring out why an iPhone insists that a perfectly good folder doesn't exist, Syncthing is an incredibly capable solution.

And once it works, there is something satisfying about it.

Open Obsidian on the Mac. Write a note.

Pick up the Android. It's there.

Pick up the iPhone. It's there too.

No import button. No export step. No cloud vault to manage.

Just a folder of Markdown files quietly moving between devices.

That's exactly what I wanted in the first place.

The file remains open.