Перейти к основному содержанию
Используйте надежный пароль для COUCHDB_PASSWORD и не публикуйте CouchDB напрямую в интернет без корректного reverse-proxy и контроля доступа.

Настройка сервера

1

Создайте рабочую директорию и базовые файлы

Создайте директорию Docker Compose и необходимые файлы:
mkdir /opt/obsidian-sync && cd /opt/obsidian-sync && mkdir couchdb && mkdir couchdb/data && touch couchdb/local.ini && micro compose.yaml
2

Создайте compose.yaml

Добавьте следующее:
compose.yaml
services:
  couchdb:
    image: couchdb:latest
    container_name: obsidiansync
    environment:
      - TZ=Europe/Moscow # can be changed
      - COUCHDB_USER=YOUR_USERNAME # important
      - COUCHDB_PASSWORD=YOUR_LONG_PASSWORD # important
    volumes:
      - ./couchdb/data:/opt/couchdb/data
      - ./couchdb/local.ini:/opt/couchdb/etc/local.ini
    ports:
      - 5984:5984
    restart: unless-stopped
3

Выполните первичную настройку CouchDB через web UI

  1. Откройте http://127.0.0.1:5984/_utils.
  2. Нажмите <->, чтобы открыть боковую панель, затем откройте Setup.
  3. Выберите Configure as single node и введите учетные данные из compose-файла.
  4. Откройте Verify installation и убедитесь, что видите Success!.
  5. Перейдите в Create Database, задайте имя и выберите Non-partitioned.
4

Примените обязательные опции CouchDB

Перейдите в Configuration и нажмите + Add option.Добавьте:
SectionOptionValue
chttpdrequire_valid_usertrue
chttpd_authrequire_valid_usertrue
httpdWWW-AuthenticateBasic realm=“couchdb”
httpdenable_corstrue
chttpdenable_corstrue
chttpdmax_http_request_size4294967296
couchdbmax_document_size50000000
corscredentialstrue
corsoriginsapp://obsidian.md,capacitor://localhost,http://localhost

Настройка клиента

1

Установите и откройте Self-hosted LiveSync

Откройте Obsidian, перейдите в Settings -> Core Plugins и установите Self-hosted LiveSync.Далее нажмите Install -> Enable -> Open setting dialog -> Options.
2

Настройте подключение к CouchDB

В верхнем ряду иконок нажмите 4-ю (🛰️) и укажите:
  • Remote type: CouchDB
  • URI: obsidian.domain.com
  • Username: YOUR_USERNAME
  • Password: YOUR_LONG_PASSWORD
  • Database: YOUR_DB_NAME
Нажмите Test в разделе Test Database connection и проверьте Connection successful!.Нажмите Check в разделе Validate Database, при необходимости примените исправления, затем Apply.
3

Настройте режим синхронизации

Перейдите на 5-ю вкладку (🔄) и выставьте:
  • Presets: Livesync
  • Sync mode: LiveSync
4

Включите статус и завершите настройку

  1. Откройте 3-ю вкладку и включите 2-й чекбокс (индикатор в статус-баре).
  2. Откройте 1-ю вкладку, пролистайте вниз и нажмите I've read everything.
  3. Вернитесь на 2-ю вкладку и нажмите Enable в разделе Enable LiveSync.
  4. Если появятся всплывающие окна, нажмите fetch и при необходимости игнорируйте предупреждение о лимите размера.
  5. Повторно проверьте режим синхронизации из шага 3.