Skip to main content

Obsidian

옵시디안은 markdown 문법으로 작성할 수 있는 크로스 플랫폼 노트 앱입니다. 즉 표준인 마크다운 문법으로 거의 웬만한 플랫폼에 앱이 있는 아주 범용성 있는 노트입니다.

  • 여러 노트 앱들과 차별화되는 높은 범용성 - markdown, cross platform
  • 무료 (유료 기능으로 sync, publish가 있다)
  • 제텔카스텐 시스템 - 노션 및 롬리서치와 비슷한 메모 시스템
  • 다양한 플러그인
  • 완전히 로컬에만 저장 가능 (월 4$에 동기화 지원)

여타 앱과 다른 특이사항으로 완전히 로컬에만 파일을 저장한다는 부분이 있는데, 장점이라고도 볼수 있지만 요즘 같은 시대엔 단점일 수밖에 없다.

하지만 이 동기화도 self-hosted로 해결할 수 있는 방법이 있다. 플러그인 중 self-hosted livesync 를 설치하고 db를 apache couchDB를 운영하면 된다.

준비사항

couchDB LXC 설치 (on proxmox). proxmox script로 couchDB LXC 설치 (설치 주소는 127.0.0.1:5984)

pangolin에서 reverse proxy로 도메인으로 연결 ( https://couchdb-sample.your.domain -> 127.0.0.1:5984)

스크린샷 2026-01-09 18.48.51.png

해당 서비스는 인증을 해야 이용할 수 있기 때문에 기본 상태확인 url을 아무것도 설정하지 않으면 비정상이 뜨면서 서비스가 연결되지 않는다. 그래서 기본적으로 상태 확인을 끄거나 healthcheck url 경로를 /_up 을 사용해야 한다.

스크린샷 2026-01-09 18.49.01.png

다만 이후 설정할 livesync plugin 을 위한 DB 설정에서 require_valid_user: true 속성을 추가해야 하는데 healthcheck url까지 인증이 걸려 사이트가 뜨지 않는 문제가 발생할 수 있다. health check에 사용하는 url에는 인증을 제외하는 require_valid_user_except_for_up: true 옵션을 추가하면 된다.

스크린샷 2026-01-09 18.52.55.png

준비한 도메인으로 접속할 때 json 응답 또는 http login dialog가 뜨면 성공.

이후엔 https://www.reddit.com/r/selfhosted/comments/1eo7knj/guide_obsidian_with_free_selfhosted_instant_sync/?tl=ko 이 문서를 따라서 db를 세팅하고 obsidian app과 연결하면 끝