# Obsidian

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

- 여러 노트 앱들과 차별화되는 높은 범용성 - markdown, cross platform
- 무료 (유료 기능으로 sync, publish가 있다)
- [제텔카스텐](https://www.google.com/search?q=%EC%A0%9C%ED%85%94%EC%B9%B4%EC%8A%A4%ED%85%90+%EB%A9%94%EB%AA%A8%EB%B2%95) 시스템 - 노션 및 롬리서치와 비슷한 메모 시스템
- 다양한 플러그인
- 완전히 로컬에만 저장 가능 (월 4$에 동기화 지원)

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

하지만 이 동기화도 self-hosted로 해결할 수 있는 방법이 있다. 플러그인 중 [self-hosted livesync](https://github.com/vrtmrz/obsidian-livesync) 를 설치하고 db를 apache couchDB를 운영하면 된다.

##### 준비사항

couchDB LXC 설치 (on proxmox). proxmox script로 [couchDB](https://community-scripts.github.io/ProxmoxVE/scripts?id=apache-couchdb&category=Databases) LXC 설치 (설치 주소는 127.0.0.1:5984)

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

[![스크린샷 2026-01-09 18.48.51.png](https://wiki.neue.nz/uploads/images/gallery/2026-01/scaled-1680-/iO09I4lsJFb1sQtd-2026-01-09-18-48-51.png)](https://wiki.neue.nz/uploads/images/gallery/2026-01/iO09I4lsJFb1sQtd-2026-01-09-18-48-51.png)

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

[![스크린샷 2026-01-09 18.49.01.png](https://wiki.neue.nz/uploads/images/gallery/2026-01/scaled-1680-/LumMfkesRfrKaHkG-2026-01-09-18-49-01.png)](https://wiki.neue.nz/uploads/images/gallery/2026-01/LumMfkesRfrKaHkG-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](https://wiki.neue.nz/uploads/images/gallery/2026-01/scaled-1680-/l1l1YJ0LxWuRS45q-2026-01-09-18-52-55.png)](https://wiki.neue.nz/uploads/images/gallery/2026-01/l1l1YJ0LxWuRS45q-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](https://www.reddit.com/r/selfhosted/comments/1eo7knj/guide_obsidian_with_free_selfhosted_instant_sync/?tl=ko) 이 문서를 따라서 db를 세팅하고 obsidian app과 연결하면 끝