# Sync an Obsidian vault on a computer

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

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

## What it does
Keep the same second-brain vault on a Mac or Windows computer, cloned with GitHub Desktop and synced by Obsidian's Git plugin every 30 minutes.

## Who it's for
Small-business owners who already sync the vault on a phone, or plan to, and want the same notes on a computer. GitHub Desktop handles the GitHub login, so there is no token to create on the computer.

## Tools
- A Mac or Windows computer
- GitHub Desktop, signed in to the GitHub account that owns the vault repo
- Git, plus Git Credential Manager (included in Git for Windows)
- Obsidian and its community plugin named Git

## Steps
1. Install GitHub Desktop and sign in. Mac: GitHub Desktop menu, Settings, Accounts, Sign Into GitHub.com. Windows: File, Options, Accounts, Sign Into GitHub.com. Click Continue With Browser and approve in the browser. GitHub Desktop handles the login, so no token is needed.
2. On GitHub, open the vault repo, click Code, then Open with GitHub Desktop. Click Choose and pick a normal folder such as Documents, not inside iCloud Drive, OneDrive or Dropbox, then click Clone. Obsidian's help warns against syncing one vault with two services.
3. Install Git as well. The Git plugin's docs say GitHub Desktop alone is not enough, because the plugin runs the computer's own Git. Windows: install Git for Windows with the default settings; it includes Git Credential Manager. Mac: per GitHub Docs, install Git and Git Credential Manager with Homebrew.
4. Install Obsidian from obsidian.md/download. In the vault switcher, choose Open folder as vault and pick the folder GitHub Desktop cloned.
5. Open Settings, turn on community plugins, then Browse. Search for Git, install the plugin named Git, and enable it. In its settings, turn on Pull on startup and set Auto commit-and-sync interval (minutes) to 30.
6. Run Git: Commit-and-sync once from the command palette. The first time, Git Credential Manager opens a browser window to sign in to GitHub. Approve it once and Git remembers the login.
7. Day to day, GitHub is the hub. Pull before editing (pull on startup does this when Obsidian opens), let auto-sync push, and let one device finish syncing before editing the same note on another.
8. If a conflict is flagged, open source control view, use Keep both on each block, edit the two versions into one note by hand, select Mark resolved, then Commit. Never force push to get past it.
9. Fallback if the plugin cannot sign in: sync with GitHub Desktop instead. Click Fetch origin and Pull origin before editing, then commit and click Push origin when done.

## Copy-paste prompt
Adapt bracketed fields to your situation.
```text
I run a small [TYPE OF BUSINESS] and I keep my business second brain in an Obsidian vault that syncs between my phone, my computer and a private GitHub repo. Write a simple folder structure and starter notes I can paste in. Plain Markdown, short notes, no plugins needed.

Write:
1. A 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, and a one-line habit: open Obsidian, let it pull, then edit.

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 (A Mac or Windows computer; GitHub Desktop, signed in to the GitHub account that owns the vault repo).
- Needs your OK: Send, pay, publish, delete, and CRM updates stay with you unless you explicitly opt in.
- Safety level: Drafts for you
- No token on the computer: GitHub Desktop signs in through the browser, and Git Credential Manager does the same for Git, so the computer needs no personal access token. GitHub's docs recommend Git Credential Manager over creating a token for this reason.
- Keep it out of cloud folders: Clone the vault into a plain folder on the computer. A vault inside iCloud Drive, OneDrive or Dropbox gets synced twice, by that service and by Git, which Obsidian's help warns can cause conflicts or corruption.
- Keep client data out: Anyone with access to the repo can read every note. Keep client personal details, passwords, card numbers and tokens out of the vault, even though the repo is private.
- The plugin cannot run Git. GitHub Desktop alone is not enough; install Git for Windows, or Git on a Mac.
- The clone landed inside iCloud Drive, OneDrive or Dropbox. Move it out: clone again into a plain folder and open that one as the vault.
- Push rejected because the remote has newer commits. Pull first. The plugin's docs say a rejected push alone is not a conflict.
- A conflict after editing the same note on two devices. Use Keep both, merge the text by hand, Mark resolved, then Commit.

## Tips
- Set up the phone first if it holds the notes, push them, then clone on the computer, so both start from the same copy.
- The 30-minute timer carries across sessions: the plugin's docs say that if Obsidian closes early, commit-and-sync runs the next time it opens. Run Git: Commit-and-sync by hand before switching devices.

## 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. GitHub Desktop, Git and the Git plugin: price Not stated in sources.

## Sources
Summaries use the public sources below, not independent verification.
- GitHub: https://docs.github.com/en/desktop/installing-and-authenticating-to-github-desktop/authenticating-to-github-in-github-desktop (GitHub Desktop sign-in: Mac, GitHub Desktop menu, Settings, Accounts, Sign Into GitHub.com; Windows, File, Options, Accounts; Continue With Browser; GitHub Desktop uses short-lived tokens (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/desktop/adding-and-cloning-repositories/cloning-a-repository-from-github-to-github-desktop (Cloning to GitHub Desktop: sign in first, open the repo, Code, Open with GitHub Desktop, Choose a local folder, Clone (read 2026-11-06 from the official github/docs repo))
- GitHub: https://docs.github.com/en/desktop/making-changes-in-a-branch/pushing-changes-to-github-from-github-desktop (Push origin sends local commits to GitHub; Fetch origin and Pull origin bring in remote commits (read 2026-11-06 from the official github/docs repo))
- GitHub: https://docs.github.com/en/get-started/git-basics/caching-your-github-credentials-in-git (Git Credential Manager signs in through a browser window, so no personal access token is needed; Git for Windows includes it; on a Mac, install Git and Git Credential Manager with Homebrew (read 2026-11-06 from the official github/docs repo))
- Obsidian: https://help.obsidian.md/install (Install Obsidian on Windows and macOS from obsidian.md/download (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/vault (Open folder as vault uses an existing folder as the vault (read 2026-11-06 from the official obsidianmd/obsidian-help repo))
- Obsidian: https://help.obsidian.md/sync-notes (Avoid syncing the same vault across multiple services to prevent data conflicts or corruption (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 (read 2026-11-06 from the official obsidianmd/obsidian-help repo))
- Obsidian Git plugin documentation: https://publish.obsidian.md/git-doc/Installation (Installation: installing GitHub Desktop is not enough on Windows, regular Git is needed, with Git Credential Manager; Mac needs Git installed (read 2026-11-06 from docs/Installation.md in the plugin's GitHub repo))
- Obsidian Git plugin: https://github.com/Vinzent03/obsidian-git (README: automatic commit-and-sync on a schedule, auto-pull on startup, conflict resolution in the editor with keep either or both versions (read 2026-11-06))
- Obsidian Git plugin documentation: https://publish.obsidian.md/git-doc/Conflict+resolution (Conflict resolution: Keep both, edit into one note, Mark resolved, then Commit; a rejected push alone is not necessarily a conflict; avoid force pushing (read 2026-11-06 from the plugin's GitHub 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-a-computer-with-github

Related:
- [Sync an Obsidian vault on iPhone](https://www.aisetupsthatwork.com/setups/sync-an-obsidian-vault-on-iphone-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)
