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

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

---

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

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

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

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

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

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

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

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

```bash
./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](../../connectivity/apps/joplin/STABLE_SETUP.md)) |
| Логин | `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](../../connectivity/apps/joplin/RUNBOOK.md); стабильная схема без смены URL — [STABLE_SETUP](../../connectivity/apps/joplin/STABLE_SETUP.md).
4. Логи: `~/Library/Logs/joplin-webdav/`

---

## Связанное

- **[Runbook: синк сломался (хотспот, логи, ETIMEDOUT)](../../connectivity/apps/joplin/RUNBOOK.md)**
- [Anytype (P2P, без WebDAV)](../anytype/README.md)
- [diagnose-phone-usb-mac.sh](../anytype/scripts/diagnose-phone-usb-mac.sh) — если понадобится USB
