Obsidian Git - Plugin for automatic vault backup with git

Hey people! Created a plugin to automatically backup your vault into git. Git itself needs to be installed and git repository needs to be initialized in the vault directory, but in near future I plan to add an option to initialize git repo from within Obsidian UI.

Let me know what you think and any feedback is welcome! :heart:

Link: https://github.com/denolehov/obsidian-git

Obsidian Git

Simple plugin that allows you to backup your Obsidian (https://obsidian.md) vault to a remote git repository (e.g. private repo on GitHub).
Synergises well with GitJournal mobile markdown note taking app.


  • Backup vault repo every X minutes
  • Automatically pull changes on Obsidian startup
  • Hotkey to pull changes (only master branch)
  • Hotkey to commit/push changes (with customizable commit message) (only master branch)

Built for Obsidian 0.9.7 with Obsidian Plugin API (alpha). But further support is planned.


I’ve installed the plugin, but am not able to get to the setup page.

I’m on the latest version (v0.9.15)
I’ve tried uninstalling and reinstalling the plugin, and re-starting obsidian. Not sure what else to try.

Looking for some other ideas.

Yes, I’m having the same issue as well. Please can someone clarify how to initialise the settings once the plugin has been installed? Thanks!

I’m having the same issue, but I think it has to do with the fact that I haven’t installed Git. The status bar is showing git:checking repo status...

Update: I was finally able to track down the issue, I had originally had my vault setup in OneDrive, then when I tried to connect GitJournal connected, I didn’t get the names correct. I was able to get my vault copied from OneDrive to GitHub, then deleted both the GitJournal and the GitHub Desktop apps, and re-installed using the same name for the repository in all instances.

can this be changed somewhere in the UI, or needs to be changed in the script?

I am trying to set up, but in obsidian there is this status message that does not change “git: checking repo status…” — what am I missing here?


Thanks for the insight! I’m also running in to issues on Windows (10). Plugin is installed and seems to be working, as there is a git:ready message in the bottom right of the main window. The settings won’t show however, so I will also try moving the vault out of OneDrive to a different location.

On OSx the plugin worked without any problems.

The problem was user error. I use Cmder on Windows which comes with git installed. I forgot to install regular Git on Windows. After installing Git for Windows the plugin menu shows and plugin is working as expected.

Obsidian Git menu does not show up on macOS Big Sur recently. I have had no problem until now. Suddenly, the menu option disappeared and I can’t use git backup. I tried uninstalling and reinstalling the plugin. Still can’t see the Obsidian Git option on the sidebar of settings.

Same problem here with Windows 10 - can’t see the Obsidian Git option on the sidebar of settings. Git for Windows already installed.

Is there any way to troubleshoot? No clue at all what went wrong.

Hey, I really value your work in the plugin, I would like help to fix it, but yet now I don’t have time to study how to contribute to plugin space, but I have feedback, whenever you use your touch bar for authentication, obsidian somehow doesn’t pick it up. Would be nice to configure which key ssh-agent would use for obsidian.

The error I’ve got even I auth it in timeout
Screenshot 2021-01-25 at 14.05.13

1 Like

For people still having issues, try opening Obsidian.MD as administrator (at least once) after installing Obsidian Git. I cannot confirm this resolves the issue for everyone, but I was able to get to the plugin settings after I did this. (Also make sure Git Bash for Windows is installed)

Same problem here. Did you eventually manage to solve it?

Anyone else had an issue with this hanging on “git: committing changes…” I can manually commit and push but the plugin seems to get stuck.

Hi all,

I’m using macOS and also note that, when installing this plug-in and enabling it, the menu option doesn’t appear. My vault is stored in a Cryptomator container, and no matter what I’ve done the option doesn’t appear. However, if I open my vault in a non-encrypted container and enable the plug-in the menu option magically appears and is able to be utilised.

While not ideal, this could be a workaround for some of you while we wait for a bug fix, and I hope that this can aid in debugging.


EDIT: After having a bit of a fiddle with some other community plug-ins it seems this issue isn’t specific to the Git plugin. @kepano minimal theme settings also has this problem, but is resolved when not in a vault within an encrypted container. This is on macOS, not sure if it applies to other OS at this stage. Food for thought!

I’ve finally managed to solve it, at least for macOS users. It seems to have to do with the command line tool:
open terminal and update it with
xcode-select --install

Anyone know where a set of log files might be to help diagnose the issue? Would gladly submit a PR to fix the problem but I’m not sure how to locate it.

Found it! Dev tools. Should have guessed. Found out this is a GPG Key Signing issue. I forgot that I do the automatic signing of commits and pushes. Now to figure out how to make it work with this plugin.

EDIT: And to complete the circle. I found this:

Made the tweak and all is well!

I really know nothing about code or this software, but I opened up a GitHub desktop app. It registers changes that I make in Obsidian. The problem is, I have to add a summary and press the button commit to Main. So it will not back up ever xx minutes and described in the app description. Wondering what I should do. Maybe get Keyboard Maestro to start the back up every five minutes. Not sure how to do that.

For Windows users this is how I got the settings page to come up.:

  1. Make sure you have downloaded git for windows
  2. Get a/sign into your github account. Create a new (private) repository.
  3. You will see a page that tells you a number of ways to set up a git folder in your computer’s file system. Copy and paste the first one into your windows terminal. This will create a .git folder in your computer. Before that, you might want to use the command cd to change the current directory of the git folder to be the same as your vault folder but I’m not sure if that’s necessary (that’s what I did anyway). (E.g cd C:\Users\winky\Documents)
  4. Restart obsidian
    The settings for the plugin should come up.