Docker로 Obsidian 설치하는 방법

작성일자 글쓴이
Docker로 Obsidian 설치하는 방법

Obsidian은 마크다운 기반의 강력한 노트 앱으로, 특히 백링크(backlink)와 그래프 뷰 기능을 제공하여 많은 사용자가 지식 관리 도구로 활용하고 있습니다. Docker를 통해 Obsidian을 설치하면, 특정 환경에서 실행하고 관리하기 쉬워지며, 필요할 때 언제든 설정을 초기화하거나 재설정할 수 있습니다. 이번 글에서는 Docker로 Obsidian을 설치하고 사용하는 방법을 단계별로 안내해 드리겠습니다.

Docker로 Obsidian 설치하기 위한 준비

Docker를 이용해 Obsidian을 설치하기 전에 다음 사항을 준비하세요:

  • Docker 설치: Docker가 설치되어 있어야 합니다. Ubuntu나 macOS 등 Linux 계열 OS에서는 터미널에서, Windows에서는 Docker Desktop을 설치합니다.
  • Docker Compose 설치: Docker Compose를 통해 컨테이너 설정을 관리할 수 있습니다. 대부분의 Docker 설치 과정에서 함께 설치되지만, 필요시 별도 설치를 진행하세요.

1. Docker 이미지 선택하기

Obsidian은 공식적으로 Docker 이미지를 제공하지 않기 때문에, 커뮤니티에서 제공하는 이미지를 사용하거나 직접 Dockerfile을 작성해야 합니다. 주로 GitHub에서 공유되는 Obsidian 관련 Docker 이미지를 사용하거나 다음과 같이 기본 설정을 직접 구성할 수 있습니다.

# Dockerfile
FROM electronuserland/builder:base

# Obsidian 설치 경로
WORKDIR /app

# Obsidian 다운로드 및 설치
RUN curl -L -o obsidian.AppImage https://github.com/obsidianmd/obsidian-releases/releases/download/v0.15.9/Obsidian-0.15.9.AppImage && \
    chmod +x obsidian.AppImage

# 컨테이너 실행 시 Obsidian 실행
CMD ["./obsidian.AppImage"]

위 Dockerfile은 Obsidian의 최신 AppImage를 다운로드하여 실행합니다. 버전 번호는 최신 릴리스에 맞게 변경해야 하며, 최신 버전 번호는 Obsidian GitHub 릴리스 페이지에서 확인할 수 있습니다.

2. Docker Compose 설정하기

Docker Compose를 사용하면 여러 설정을 파일로 관리할 수 있어 컨테이너를 좀 더 쉽게 실행할 수 있습니다. 다음은 Docker Compose 파일 예시입니다:

# docker-compose.yml
version: '3'
services:
  obsidian:
    build:
      context: .
      dockerfile: Dockerfile
    volumes:
      - ./obsidian_data:/root/.config/obsidian
    ports:
      - "8080:8080"
    environment:
      - DISPLAY=${DISPLAY}
    network_mode: "host"

Docker Compose 파일 설명

  • volumes: obsidian_data라는 로컬 폴더를 컨테이너 내부 Obsidian 설정 폴더에 연결하여, 노트 및 설정 데이터를 유지할 수 있도록 합니다.
  • ports: 필요한 경우 외부에서 접속할 수 있는 포트를 설정합니다.
  • environment: Obsidian은 GUI 애플리케이션이므로, DISPLAY 환경 변수를 설정하여 로컬 화면에 띄울 수 있도록 합니다.
  • network_mode: 호스트 네트워크를 통해 성능을 최적화할 수 있습니다.

3. 컨테이너 빌드 및 실행

  1. Docker 이미지 빌드하기 Dockerfile이 있는 폴더에서 다음 명령어를 통해 이미지를 빌드합니다:
   docker-compose build
  1. Docker 컨테이너 실행하기 이미지를 빌드한 후, Docker Compose 명령어를 통해 컨테이너를 실행합니다:
   docker-compose up -d

-d 옵션은 컨테이너를 백그라운드에서 실행합니다. 필요에 따라 docker-compose up으로 실시간 로그를 확인하며 실행할 수 있습니다.

  1. Obsidian 실행 확인 Obsidian이 실행 중인지 확인하려면 다음 명령어를 사용하여 컨테이너 상태를 체크합니다:
   docker ps

실행 중인 컨테이너 목록에 obsidian 서비스가 나타나면 성공적으로 실행된 것입니다.

4. 로컬 네트워크에서 Obsidian 접속하기

GUI 애플리케이션인 Obsidian을 Docker로 실행하는 경우, 로컬 환경에서 네트워크를 통해 접속해야 합니다. X11 서버 또는 VNC와 같은 원격 디스플레이 도구를 사용할 수 있습니다. 이 과정은 복잡할 수 있으므로, 원활한 실행을 위해 VNC를 설치해 로컬 환경에서 접속하는 방법을 고려해 보세요.

VNC 서버 추가 설정 예시

Dockerfile 또는 docker-compose 파일에 VNC 서버 설정을 추가하여 Obsidian을 실행하면 다음과 같은 방식으로 원격으로 접속할 수 있습니다:

RUN apt-get update && \
    apt-get install -y x11vnc xvfb && \
    x11vnc -storepasswd yourpassword /root/.vnc/passwd

CMD ["x11vnc", "-forever", "-usepw", "-create"]

이 설정을 통해 로컬 VNC 클라이언트로 Docker에서 실행 중인 Obsidian에 접속할 수 있습니다.

5. 종료 및 재시작

Docker로 설치한 Obsidian을 종료하거나 재시작하려면 다음 명령어를 사용할 수 있습니다:

  • 종료: docker-compose down
  • 재시작: docker-compose restart

이 명령어로 설정 및 노트가 보존된 상태에서 손쉽게 컨테이너를 재시작할 수 있습니다.

마무리

Docker를 이용해 Obsidian을 설치하면, 별도의 환경 설정이나 재설치 없이 Obsidian을 빠르게 실행할 수 있어 관리가 편리해집니다. 특히 개발 환경이나 여러 장치에서 동일한 설정을 유지하고 싶은 분들에게 유용한 방법입니다.

혹시 Docker로 Obsidian을 설치하면서 어려움을 겪거나 더 궁금한 사항이 있다면, 아래에 댓글로 공유해 주세요! 😊