Obsidian

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

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

하지만 이 동기화도 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과 연결하면 끝


Revision #3
Created 2026-01-09 09:31:53 UTC by amati
Updated 2026-01-16 03:04:01 UTC by amati roh