# Sync an Obsidian vault on iPhone

> Researched. Small business · Intermediate · Research. Updated 2026-11-06.

Canonical page: https://www.aisetupsthatwork.com/setups/sync-an-obsidian-vault-on-iphone-with-github/

## What it does
Keep a business second-brain vault on an iPhone in sync with a private GitHub repo, using Obsidian's Git plugin and a token limited to one repo.

## Who it's for
Small-business owners who keep notes on the phone and want the same notes in a private GitHub repo, with no computer needed. Expect some trial and error: Git on a phone is the weak spot.

## Tools
- An iPhone with Obsidian from the App Store
- A GitHub account and a private repo for the vault
- The Obsidian community plugin named Git (the obsidian-git project)
- A fine-grained GitHub token that reaches only the vault repo
- Optional fallback: the Working Copy app

## Steps
1. In Safari, sign in to GitHub and create a private repo for the vault: the plus menu, then New repository. Tick the option to add a README so the repo is not empty. GitHub says a private repo is open only to you and people you share it with.
2. Install Obsidian from the App Store and open it. Tap Create new vault, give it a name, and leave Store in iCloud switched off. The Git plugin's docs say not to pick Store in iCloud, and Obsidian's help warns against syncing one vault with two services.
3. In Obsidian, open Settings and tap Turn on community plugins, then Browse. Search for Git, install the plugin named Git, and tap Enable. Obsidian warns that community plugins run third-party code, so add only what the job needs.
4. Back in Safari on GitHub: tap the profile picture, then Settings, Developer settings, Personal access tokens, Fine-grained tokens, Generate new token. Name it after the vault and set Expiration about 90 days out.
5. Under Repository access, pick Only select repositories and choose the vault repo only. Under Permissions, set Contents to Read and write, and Commit statuses to Read and write, the two the plugin's docs list. GitHub adds read access to Metadata by itself. Leave everything else off, then tap Generate token.
6. Copy the token and paste it only into the plugin, in the next step. Never paste it into a chat, a note, an email or a file in the repo.
7. In Obsidian, open Settings, then the Git plugin's options at the bottom under Community plugins. Under Identity, type the GitHub username in Username on your Git server, then create a secret for Git server password or access token and paste the token there. Leave the Advanced settings alone.
8. Open the command palette and run Git: Clone an existing remote repo. Enter the repo's https address with .git on the end, such as https://github.com/your-username/your-vault.git, not the address in the browser bar. Choose the vault root as the folder, then wait for the popup asking to restart Obsidian and restart it.
9. In the plugin settings, fill in Repository author name and Repository author email (mobile Git has no default for them). Turn on Pull on startup and set Auto commit-and-sync interval (minutes) to 30.
10. Test it: write a short note, run Git: Commit-and-sync from the command palette, and check that the note appears in the repo on GitHub. Then paste the prompt below into ChatGPT or Claude for a starter folder layout.
11. Fallback if the clone crashes or never finishes: close Obsidian, clone the repo in the Working Copy app with the same https address, the username, and the token as the password. In the Files app, copy that folder over the empty vault, reopen Obsidian, enable the Git plugin and run Git: Pull. Pushing from inside Working Copy needs its paid Pro upgrade.

## Copy-paste prompt
Adapt bracketed fields to your situation.
```text
I run a small [TYPE OF BUSINESS] and I am setting up an Obsidian vault as my business second brain. It syncs to a private GitHub repo from my iPhone, so keep it small: plain Markdown, short notes, no plugins needed.

Write:
1. A simple folder list with one line on what goes in each folder.
2. A Facts note: business name, services, hours, prices, service area and the tools I use, with [BRACKETS] for me to fill in.
3. A Decisions note: a table with date, decision, why, and what would change my mind.
4. A Log note: one dated line per entry, newest at the top.
5. An Inbox note for quick captures that I sort once a week.
6. A Wins and snags note: what worked, what broke, what to try next.
7. A short README for the top of the vault that says what each note is for.

Rules:
- Never ask me for passwords, tokens, card numbers or client personal details, and add a line to the README saying those stay out of the vault.
- Use file names with no spaces or special characters, so they work on an iPhone, a Mac and Windows.
- Show me the folder list first and wait for my OK before you write the notes.
```

## Guardrails
- What it touches: Chat input you provide (An iPhone with Obsidian from the App Store; A GitHub account and a private repo for the vault).
- Needs your OK: Send, pay, publish, and account changes stay with you. Treat agent output as drafts first.
- Safety level: Drafts for you
- Mobile Git is the weak spot: The Git plugin's docs call mobile support experimental and very unstable, and do not recommend it on a phone. On iOS it runs a JavaScript version of Git, which is slower than desktop, limits repo size and can crash during a clone or pull. Keep the vault to text notes and keep the Working Copy fallback in mind.
- The token is a password: GitHub says to treat tokens like passwords. Give this one a single repo, only the Contents and Commit statuses permissions, and an expiry about 90 days out. Paste it only into the plugin's secret field. When it expires, GitHub revokes it and sync stops until a new token goes in.
- Keep client data out: Anyone with access to the repo, or with a leaked token, can read every note. Keep client personal details, passwords, card numbers and tokens out of the vault, even though the repo is private.
- Store in iCloud switched on when the vault was made. Make a new vault stored on the iPhone and clone again.
- Pasting the browser address. The clone needs the https address ending in .git.
- Obsidian crashes or hangs during the clone. The plugin's docs say this depends on the device and free memory; use the Working Copy clone instead.
- Sync stops after about 90 days. The token expired; make a new one with the same settings and replace the secret.
- A conflict after editing the same note on two devices. Open source control view, use Keep both, edit the note into one version, select Mark resolved, then commit.

## Tips
- Keep the vault small. The plugin's docs say repo size on mobile is limited by memory, and large vaults are the ones that crash.
- Use plain file names. The plugin's docs warn that a name that works on one system can block a pull on another.
- Set a reminder a week before the token expires, so sync does not stop without warning.
- Run the starter prompt once, paste the notes in, and let auto commit-and-sync push them.

## Estimates (labeled, not measured)
- Time saved: Not stated in sources.
- Money saved: Not stated in sources.
- Tool cost: Obsidian: free to use, and commercial licenses are optional, per Obsidian's help. GitHub: private repos are included on GitHub Free for personal accounts, per GitHub Docs. The Git plugin: price Not stated in sources. Working Copy, the fallback only: pushing needs its paid Pro upgrade; price Not stated in sources.

## Sources
Summaries use the public sources below, not independent verification.
- Obsidian: https://help.obsidian.md/install (Install Obsidian on iPhone and iPad: find Obsidian on the App Store and tap Get (read 2026-11-06 from the page source in the official obsidianmd/obsidian-help repo on GitHub; help.obsidian.md itself could not be opened from the session))
- Obsidian: https://help.obsidian.md/sync-notes (Sync your notes across devices: on iOS, Create new vault has a Store in iCloud toggle; avoid syncing the same vault across multiple services; Working Copy works for Git on iOS, and some of its features require a paid in-app purchase (read 2026-11-06 from the official obsidianmd/obsidian-help repo))
- Obsidian: https://help.obsidian.md/community-plugins (Community plugins: Settings, Turn on community plugins, Browse, Install, Enable; community plugins run third-party code (read 2026-11-06 from the official obsidianmd/obsidian-help repo))
- Obsidian: https://help.obsidian.md/teams/license (Commercial license: Obsidian is free to use; commercial licenses are optional (read 2026-11-06 from the official obsidianmd/obsidian-help repo))
- Obsidian Git plugin: https://github.com/Vinzent03/obsidian-git (README: mobile support is experimental and very unstable; mobile uses isomorphic-git, with no SSH, limited repo size, and possible crashes on clone or pull; features include auto commit-and-sync on a schedule and auto-pull on startup (read 2026-11-06))
- Obsidian Git plugin documentation: https://publish.obsidian.md/git-doc/Getting+Started (Getting Started, Mobile: do not select Store in iCloud; GitHub needs a personal access token with Metadata read and Contents and commit status read and write; enter the username and a secret under Identity; leave Advanced alone; run Clone an existing remote repo with the https URL ending in .git; wait for the restart popup; Working Copy can do the first clone and is a paid app (read 2026-11-06 from docs/Getting Started.md in the plugin's GitHub repo))
- Obsidian Git plugin documentation: https://publish.obsidian.md/git-doc/Conflict+resolution (Conflict resolution: open source control view, Keep ours, Keep theirs or Keep both, Mark resolved, then Commit; avoid force pushing (read 2026-11-06 from the plugin's GitHub repo))
- GitHub: https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens (Fine-grained tokens: Settings, Developer settings, Personal access tokens, Fine-grained tokens, Generate new token; pick an expiration; Only select repositories; choose the minimal permissions; treat tokens like passwords; a token goes in place of the password for Git over HTTPS (read 2026-11-06 from the official github/docs repo; docs.github.com itself could not be opened from the session))
- GitHub: https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/token-expiration-and-revocation (A token is revoked when it reaches its expiration date and cannot be restored; a new token is needed (read 2026-11-06 from the official github/docs repo))
- GitHub: https://docs.github.com/en/repositories/creating-and-managing-repositories/creating-a-new-repository (Create a repository from the plus menu, New repository; choose visibility; optionally add a README (read 2026-11-06 from the official github/docs repo))
- GitHub: https://docs.github.com/en/repositories/creating-and-managing-repositories/about-repositories (Private repositories are accessible only to the owner and people given access; GitHub Free includes unlimited private repositories with a limited feature set (read 2026-11-06 from the official github/docs repo))

## Get the free starter pack
Five beginner copy-paste AI setups, free by email: https://www.aisetupsthatwork.com/starter-pack/?utm_source=ai-agent&utm_medium=markdown&utm_campaign=setup-sync-an-obsidian-vault-on-iphone-with-github

Related:
- [Sync an Obsidian vault on a computer](https://www.aisetupsthatwork.com/setups/sync-an-obsidian-vault-on-a-computer-with-github/index.md)
- [How to give your AI bot a long-term memory with an Obsidian vault](https://www.aisetupsthatwork.com/setups/give-your-ai-bot-a-long-term-memory-with-obsidian/index.md)
- [Make AI write in your voice](https://www.aisetupsthatwork.com/setups/make-ai-write-in-your-voice/index.md)
