From 5d5432b1e56ea1c1e9062b2f2cb457a18fcc5108 Mon Sep 17 00:00:00 2001
From: Alexey Martemyanov <mallexxx@gmail.com>
Date: Mon, 18 May 2026 05:10:31 +0600
Subject: [PATCH] Failed to authenticate. API Error: 401 Invalid authentication
 credentials [2026-05-18] vault sync

---
 wiki/tech/hermes-docker-kraken.md    | 46 ++++++++++++++++++++++
 wiki/tech/jellyfin-transcode-rpi5.md | 57 ++++++++++++++++++++++++++++
 wiki/tech/truenas-inpxer.md          | 36 ++++++++++++++++++
 3 files changed, 139 insertions(+)
 create mode 100644 wiki/tech/hermes-docker-kraken.md
 create mode 100644 wiki/tech/jellyfin-transcode-rpi5.md
 create mode 100644 wiki/tech/truenas-inpxer.md

diff --git a/wiki/tech/hermes-docker-kraken.md b/wiki/tech/hermes-docker-kraken.md
new file mode 100644
index 00000000..4bde9171
--- /dev/null
+++ b/wiki/tech/hermes-docker-kraken.md
@@ -0,0 +1,46 @@
+---
+title: Hermes Docker на Кракене — Правила запуска
+type: reference
+tags:
+  - hermes
+  - docker
+  - kraken
+  - pitfalls
+created: '2026-05-18'
+updated: '2026-05-18'
+---
+# Hermes Docker на Кракене — Правила запуска
+
+## Почему не compose
+
+`docker compose` ломается из-за long-lived process detection — Hermes gateway — постоянный процесс, что compose интерпретирует как зависание.
+
+**Решение:** запускать через `docker run` напрямую.
+
+## Правильная команда
+
+```bash
+docker run -d \
+  --name hermes-kraken \
+  --restart unless-stopped \
+  --network host \
+  -v /home/kraken/hermes/config:/opt/data \
+  -v /home/kraken/obsidian:/vault:rw \
+  -e HERMES_ALLOW_ROOT_GATEWAY=1 \
+  -e HERMES_SKIP_CHOWN=1 \
+  --env-file /home/kraken/hermes/.env \
+  -t -i \
+  hermes-kraken:latest gateway
+```
+
+## Pitfall: HERMES_UID/GID
+
+**НЕ** задавать `HERMES_UID` / `HERMES_GID` — иначе при каждом старте выполняется `chown -R` на `.venv`, что вешает контейнер на несколько минут.
+
+## Итог
+
+| Переменная | Значение |
+|------------|---------|
+| `HERMES_ALLOW_ROOT_GATEWAY` | `1` |
+| `HERMES_SKIP_CHOWN` | `1` |
+| `HERMES_UID/GID` | ❌ не задавать |
diff --git a/wiki/tech/jellyfin-transcode-rpi5.md b/wiki/tech/jellyfin-transcode-rpi5.md
new file mode 100644
index 00000000..424e4663
--- /dev/null
+++ b/wiki/tech/jellyfin-transcode-rpi5.md
@@ -0,0 +1,57 @@
+---
+title: Jellyfin Транскод на RPi5 — PGS/Subtitle Pitfalls
+type: reference
+tags:
+  - jellyfin
+  - kraken
+  - transcode
+  - subtitles
+  - pitfalls
+created: '2026-05-18'
+updated: '2026-05-18'
+---
+# Jellyfin Транскод на RPi5 — PGS/Subtitle Pitfalls
+
+## Контекст
+
+Клиент: Konka TV с WebOS. Сервер: Raspberry Pi 5 (Крaken, ARM64).
+
+## Direct Play условия
+
+Direct Play работает при выполнении всех условий:
+- Аудио: AAC
+- Субтитры: **отсутствуют** (или внешние SRT, без burn-in)
+
+## Проблема PGS/ASS субтитров
+
+PGS и ASS (SSA) субтитры вызывают **burn-in** — Jellyfin рендерит субтитры прямо в видеопоток.
+
+**Результат:** полный транскод на CPU → **275% CPU load** на RPi5 → лаги, перегрев.
+
+**Экспериментальный PGS rendering** в настройках Jellyfin — **не помогает** на RPi5.
+
+## Решение: конвертация PGS → SRT
+
+Для всей библиотеки конвертировать PGS-субтитры в SRT через `pgsrip`:
+
+```bash
+# Установка
+pip install pgsrip
+
+# Конвертация одного файла (MKV с PGS)
+pgsrip film.mkv --language rus
+
+# Массовая конвертация
+find /media -name "*.mkv" | xargs -I{} pgsrip "{}" --language rus
+```
+
+После конвертации: внешние `.srt` файлы Jellyfin читает без транскода.
+
+## Итог по субтитрам
+
+| Тип | Direct Play | Транскод |
+|-----|------------|---------|
+| Нет субтитров | ✅ | — |
+| Внешний SRT | ✅ | — |
+| ASS/SSA | ❌ | burn-in, 275% CPU |
+| PGS (MKS/MKV) | ❌ | burn-in, 275% CPU |
diff --git a/wiki/tech/truenas-inpxer.md b/wiki/tech/truenas-inpxer.md
new file mode 100644
index 00000000..284d12e7
--- /dev/null
+++ b/wiki/tech/truenas-inpxer.md
@@ -0,0 +1,36 @@
+---
+title: TrueNAS Inpxer — Книги & Pitfalls
+type: reference
+tags:
+  - truenas
+  - inpxer
+  - books
+  - pitfalls
+created: '2026-05-18'
+updated: '2026-05-18'
+---
+# TrueNAS Inpxer — Книги & Pitfalls
+
+## Пути
+
+| | |
+|--|--|
+| Хранилище книг | `/mnt/RED_2TB/Edu/` (214 GB) |
+| Загрузка новых | `/mnt/RED_2TB/storage/books/` |
+| Inpxer UI | `books.mallexxx.duckdns.org` |
+
+## Pitfall: Badger DB блокировка
+
+**Проблема:** Badger DB (используется inpxer) блокируется при параллельных загрузках.
+
+**Симптом:** ошибка блокировки БД при параллельном добавлении книг.
+
+**Решение:** качать книги по одной, пауза 3 секунды между загрузками.
+
+```bash
+# Не делать так (параллельно):
+for book in *.epub; do upload "$book"; done
+
+# Правильно (последовательно с паузой):
+for book in *.epub; do upload "$book"; sleep 3; done
+```