Perfluorodecalin

Obsidian: Git is not ready. 옵시디언 Git 설정 오류 해결 방법

5 min read

Obsidian 문제인지, Obsidian Git Plugin 문제인지..
개발 PC에서 설정할 때는 같은 문제가 없었는데 개인 PC에 신규로 옵시디언과 플러그인 세팅을 하자 처음 보는 에러 메시지가 나타났다.

현상, 에러 메시지

Git is not ready. When all settings are correct you can configure commit-sync, etc.

플러그인 설치 직후 Option 창으로 이동했는데, Git 관련 설정들이 보이지 않고 상단에 위의 에러 메시지가 표시된다.
로컬 PC에 Git이 오래된 버전인가 싶어서 업데이트 했는데도 문제가 해결되지 않았다.

Git Plugin Documentation 확인

문제가 생겼을 때는, 첫 Install 시에 사전 준비를 제대로 하지 않았을 가능성이 가장 크다.
그리고 대부분의 문제는 공식 문서를 꼼꼼히 보면 해결된다.

Obsidian Git Plugin Documentation

Installation 문서를 보면 다음과 같은 메뉴얼이 제공된다.

Manual 

  1. Download obsidian-git-<latest-version>.zip from the latest release
  2. Unpack the zip in <vault>/.obsidian/plugins/obsidian-git
  3. Reload Obsidian (CTRL + R)
  4. Go to settings and disable restricted mode
  5. Enable Git

그리고 Windows와 Linux 에서 추가적으로 작업해야할 내용들이 있었다.

Windows

Git 설치 확인

일단 Git이 설치되어있는지 확인해본다.
터미널에서 아래의 커맨드를 입력해서 결과가 경로로 정상적으로 나오는지 확인한다.

where git

Git 설치

간혹 GitHub Desktop 을 설치해서 동기화 하려고 시도하는 경우도 있는 모양이다.
GitHub Desktop 설치로는 충분하지 않고 일반적인 Git을 설치해야한다고 안내되어있다.

Info

Git 2.29 버전 또는 그 이상을 설치 필요 (25년 7월 기준)

Git 설치는 공식 웹사이트를 참고하면 된다.
설치 과정에서 3rd-party software를 enabled 하는 것을 유념하자.

Git Credential Manager를 활성화 한다.
설치 시에 해당 옵션 선택하는 부분이 나오지 않을 수도 있는데, 콘솔 창에 아래 커맨드를 입력했을 때 manager 라고 나오면 제대로 설정되어있는것이다.

git config credential.helper

이 설정을 완료해야 Obsidian에서 Git 인증을 GitHub 인증 웹 팝업으로 할 수 있다.

시도 결과

문제는.. Git도 다시 재설정하고, Credential manager 설정도 잘 됐는데도 불구하고 문제해결이 안된다는 것이다..
물론 설치 시에 해야하는 기본 설정은 되었어야 하는거니까 필요한 작업이긴 했다.
다른 원인을 찾아보자.

Git Plugin Setting 의 Advanced 확인

도큐먼트에서 이야기하는 매뉴얼 대로 했는데도 적용이 안되는 거면 다음은 설정 확인이다.
설정 상단에서는 Git이 준비가 안됐다고만 나와있지만..
사실상 Git은 플러그인에서 설정 기본값 상 현재의 Obsidian Vault 하위에 .git 폴더 내에 각종 설정들이 잡혀야 하는데 간혹 Vault 구조가 꼬였으면 설정 기본값들이 제대로 잡히지 않는 모양이다.

Custom base path 설정 확인

이 경우 확인해야 할 설정은 Custom base path (Git repository path)이다.
해당 설정에 해당 Vault의 이름을 그대로 입력해서 적용해보자.

ex) Vault이름이 Obsidian_Vault 라면 해당 속성에 Obsidian_Vault라고 설정함

시도 결과: 최종 해결

본래 이미 개발 PC에서 내용만 커밋해두었던 Remote Repo를 개인 PC 로 Clone하려고 했던것이었기때문에, 설정 후 Obsidian 의 command palette에서 Git: Clone an existing remote repo를 실행시켜보았다.

GitHub Credential 팝업이 실행되었고, 웹에서 인증 후 성공적으로 로컬에 Clone할 수 있었다.

그래프 뷰