Ubuntu에 Obsidian 설정 및 Git & Android와 동기화 (단계별)

Source: Dev.to

왜 Obsidian + Git?

• Markdown 기반, 미래에도 안전한 노트
• 전체 버전 기록 (클라우드 동기화 도구와 달리)
• 개인 저장소 = 데이터에 대한 완전한 제어
• Linux, Windows, Android 모두에서 작동

1단계: Ubuntu에 Obsidian 설치

Download the .deb package from the official site:
https://obsidian.md/download

Install using gdebi (it resolves dependencies automatically):

sudo apt-get update
sudo apt-get install gdebi

Open the downloaded .deb file with GDebi Package Installer and install Obsidian.

2단계: 비공개 GitHub 저장소 만들기

1. GitHub에 가서 새 저장소를 만드세요.
2. Private(비공개)로 설정하세요.
3. Do not initialize with a README (Obsidian이 자동으로 채워줍니다).

Step 3: SSH를 사용하여 저장소 복제 (데스크톱)

cd ~/Documents
git clone git@github.com:DasDNS/Obsidian_Notes.git

다음과 유사한 출력이 표시됩니다:

Cloning into 'Obsidian_Notes'...
Receiving objects: 100% (4/4), done.

원격을 확인합니다:

cd Obsidian_Notes
git remote -v

출력:

origin  git@github.com:DasDNS/Obsidian_Notes.git (fetch)
origin  git@github.com:DasDNS/Obsidian_Notes.git (push)

Step 4: Obsidian에서 볼트 열기 (Ubuntu)

1. Obsidian을 엽니다.
2. Open folder as vault를 클릭합니다.
3. Obsidian_Notes를 선택합니다.
4. 노트 작성을 시작합니다.

단계 5: Obsidian Git 플러그인 설치 및 구성 (데스크톱)

1. Settings → Community Plugins 로 이동합니다.
2. Safe Mode를 비활성화합니다.
3. Obsidian Git을 설치하고 플러그인을 활성화합니다.

권장 설정

• 간격에 따라 자동 커밋
• 시작 시 자동 풀
• (선택 사항) 커밋 메시지 템플릿

이제 노트가 자동으로 커밋되고 동기화됩니다.

Step 6: Why Android Needs HTTPS (Important)

• Obsidian Git on Android does NOT support SSH.
• It does support HTTPS with a Personal Access Token (PAT).

We keep SSH on the desktop and create an HTTPS‑compatible copy of the vault for Android.

단계 7: HTTPS‑호환 복사본 만들기 (데스크톱)

볼트를 복제합니다:

cp -r ~/Documents/Obsidian_Notes ~/Documents/Obsidian_Notes_HTTPS
cd ~/Documents/Obsidian_Notes_HTTPS

원격을 SSH에서 HTTPS로 변경합니다:

git remote set-url origin https://github.com/DasDNS/Obsidian_Notes.git

확인:

git remote -v

출력:

origin  https://github.com/DasDNS/Obsidian_Notes.git (fetch)
origin  https://github.com/DasDNS/Obsidian_Notes.git (push)

이제 저장소가 Android와 호환됩니다.

Step 8: Copy the Vault to Android

1. USB로 휴대폰을 연결하고 File Transfer (MTP) 를 활성화합니다.
2. 전체 폴더를 복사합니다. 포함 항목:
   • .git/
   • .obsidian/
   • 모든 마크다운 파일

Recommended location on the device:

Internal Storage / Obsidian

Note: 폴더 자체를 복사하고, 내용만 복사하지 마세요.

Step 9: Android에 Obsidian 설치

• Play Store에서 Obsidian을 설치합니다.
• 앱을 열고 Open existing folder를 선택합니다.
• 복사한 Obsidian 폴더를 선택합니다.

Step 10: Git Sync on Android (Access Token Required)

1. Settings → Community Plugins 로 이동하여 Obsidian Git 을 활성화합니다.
2. Command Palette 를 열고 Obsidian Git: Pull 을 실행합니다.

다음 항목을 입력하라는 메시지가 표시됩니다:

• Username → GitHub 사용자 이름
• Password → Personal Access Token (PAT)

SSH 키는 Android에서 작동하지 않으며 토큰이 필수입니다.

토큰을 입력하면 Obsidian Git이 업데이트를 Pull하고, 변경 사항을 커밋한 뒤 GitHub에 푸시합니다.

최종 결과

• Ubuntu → SSH Git (보안 및 빠른)
• Android → HTTPS Git (토큰 기반)
• 동일한 개인 저장소
• 전체 버전 기록
• 오프라인 우선 노트

최종 생각

This setup gives you:

• 데이터에 대한 완전한 제어
• 유료 동기화 서비스 없음
• 학생 노트부터 연구 아카이브까지 확장 가능한 워크플로우

If you’re serious about long‑term note‑taking, Obsidian + Git is worth the effort.

References

• Obsidian + GitLab Setup (Andrew Wegner) – 데스크톱 Git 단계에 참고가 된 상세한 워크스루.
• Obsidian Android Syncing via GitHub (Reddit) – GitHub와 개인 액세스 토큰을 사용해 Android에서 Obsidian을 동기화하는 커뮤니티 토론.