local_machine/docs/apps/joplin

Joplin — локальный синк Mac ↔ телефон (WebDAV, без Docker)

Синхронизация через rclone WebDAV только в локальной сети. Данные на Mac в ~/JoplinSync. Облака Joplin/Dropbox не используются.

---

Быстрый старт (Mac)

brew install rclone   # если ещё нет
chmod +x ./docs/apps/joplin/scripts/joplin-webdav-*.sh
./docs/apps/joplin/scripts/joplin-webdav-install.sh

Показать URL и статус:

./docs/apps/joplin/scripts/joplin-webdav-status.sh

Учётка: ~/.config/joplin-webdav/env (права 600, не коммитить).

Остановка / запуск:

./docs/apps/joplin/scripts/joplin-webdav-stop.sh
./docs/apps/joplin/scripts/joplin-webdav-serve.sh

После смены пароля в ~/.config/joplin-webdav/env — обязательно перезапуск (иначе rclone держит старый пароль → 401):

./docs/apps/joplin/scripts/joplin-webdav-reload.sh

Пароль в Joplin на телефоне и Mac должен совпадать с JOPLIN_WEBDAV_PASS в env, не со старым из установки.

Автозапуск при входе: LaunchAgent com.eternal.joplin-webdav (ставится install-скриптом).

---

Настройка Joplin (Mac и телефон)

1. Настройки → Синхронизация
2. Внизу: Self-hosting → Click here to select one
3. WebDAV
4. Заполнить:

Поле	Значение
WebDAV URL	Mac: http://127.0.0.1:8080 · Телефон: http://10.219.227.100:8080 (статический IP на Mac — STABLE_SETUP)
Логин	joplin
Пароль	из ~/.config/joplin-webdav/env → JOPLIN_WEBDAV_PASS

5. Проверить конфигурацию синхронизации → OK → синхронизировать.

Важно: Mac и телефон в одной сети (хотспот телефона). URL с http://, не https://. Без слэша в конце URL.

Опционально: Настройки → Шифрование — E2EE (мастер-пароль), на сервере только шифротекст.

---

Приватность

• Заметки на телефоне — в песочнице Joplin, не «доступ ко всем файлам».
• WebDAV слушает 0.0.0.0:8080 только пока запущен rclone; не открывайте порт в интернет.
• При включённом фаерволе macOS разрешите вход для rclone или порта 8080 в локальной сети.

---

Если не коннектится с телефона

1. ./docs/apps/joplin/scripts/joplin-webdav-status.sh — процесс и IP.
2. На телефоне в браузере: http://IP_MAC:8080 (может запросить логин — значит сеть доходит).
3. Синк сломался — RUNBOOK; стабильная схема без смены URL — STABLE_SETUP.
4. Логи: ~/Library/Logs/joplin-webdav/

---

Связанное

• Runbook: синк сломался (хотспот, логи, ETIMEDOUT)
• Anytype (P2P, без WebDAV)
• diagnose-phone-usb-mac.sh — если понадобится USB