obsidian-vault/personal/tech/jellyfin-db-schema-mismatch.md

Jellyfin: сервер старше БД — no such column: p.Permission_Permissions_Guid

Обнаружено: 2026-09-20 на Kraken (RPi5/OMV, arm64, Docker). Статус: ✅ ЗАФИКСИРОВАНО 2026-09-20 — контейнер пересоздан на образе 12.1.0.0, jellyfin healthy, Alex подтвердил «Заработало». См. раздел «Результат» ниже. Симптом: jellyfin не подключается (http://kraken:8096 → 503), контейнер Up но unhealthy, health-check бесконечно пишет Server is could not complete startup. Check logs. Связанные: personal/tech/docker-data-root-mount-race, family/how-to/kraken-access, family/plans/kraken-backup-to-truenas

Суть (коротко)

БД jellyfin.db мигрирована под Jellyfin 12.1.0.0, а запущенный контейнер работает на образе 10.11.8. Сервер 10.11.8 ожидает старую схему таблицы Permissions (с колонкой Permission_Permissions_Guid), а в 12.x-схеме её больше нет → падение на конструкторе UserManager → сервер не стартует.

Это не «миграция не прошла». Наоборот: миграции применены вперёд, а сервер откатился назад.

Диагностика (воспроизводимая)

# 1) внешний симптом
ssh kraken 'docker exec jellyfin sh -c "curl -s -o /dev/null -w \"%{http_code}\n\" http://localhost:8096/"'
#  → 503

# 2) статус
ssh kraken 'docker ps --format "{{.Names}} {{.Status}}" | grep jelly'
#  → jellyfin Up ... (unhealthy)

# 3) ГДЕ ЛОГ: jellyfin пишет в ФАЙЛ, не в stdout!
#    docker logs пуст по свежему запуску — не путаться.
ssh kraken 'sudo docker exec jellyfin sh -c "ls -lat /config/log/"'
ssh kraken 'sudo docker exec jellyfin sh -c "grep -nE \"SqliteException|could not complete startup\" /config/log/log_20260920.log | head"'
#  → SQLite Error 1: 'no such column: p.Permission_Permissions_Guid'

# 4) какая версия сервера РЕАЛЬНО запущена
ssh kraken 'docker exec jellyfin sh -c "/jellyfin/jellyfin --version"'
#  → Jellyfin.Server 10.11.8.0

# 5) какой образ у контейнера vs локальный latest
ssh kraken 'docker inspect jellyfin --format "{{.Image}}"'
ssh kraken 'docker inspect jellyfin/jellyfin:latest --format "{{.Id}}"'
#  → РАЗНЫЕ ID

# 6) до какой версии мигрирована БД (на Mac, копия БД)
#    см. скрипт ниже: миграции по ProductVersion

Разбор БД (скопировать на Mac, не трогая оригинал)

ssh kraken 'sudo docker cp jellyfin:/config/data/jellyfin.db /tmp/jf.db && sudo chmod 644 /tmp/jf.db'
scp kraken:/tmp/jf.db /Users/admin/kraken-recovery/jellyfin-db/jellyfin.db
# затем python3: SELECT ProductVersion, COUNT(*) FROM __EFMigrationsHistory GROUP BY ProductVersion
# скрипт-разбор: /Users/admin/kraken-recovery/inspect_db.py, inspect_db2.py

Факты инцидента (2026-09-20)

Что	Значение
Образ контейнера	sha256:1694ff06... = 10.11.8
Образ локальный latest	sha256:78d3ea12... = 12.1.0.0 (обновлён 15.09)
БД jellyfin.db мигрирована до	12.1.0.0 (последняя миграция 20260911120000_StripEmbeddedLinkedChildren)
Миграций в __EFMigrationsHistory	105 (наборы: 9.0.11 ×36, 10.0.11 ×19, 10.11.8 ×32, 12.0.0 ×15, 12.1.0 ×3)
Схема Permissions в БД	без Permission_Permissions_Guid (12.x-форма)
Контейнер создан	26.05.2026, не пересоздавался
Первое падение в логе	09:57 (до shutdown Kraken) — дефект не от перезагрузки
SQLiteBackups/ (авто-бэкапы)	пуст
Единственный бэкап БД	jellyfin.db.backup-20260617_034429 (17.06)

Как это получилось

latest указывал на 10.11.8 в мае → контейнер создан на этом образе. 15.09 latest на Hub обновился до 12.1. Контейнер в какой-то момент запустился на новом образе (или compose пересоздал его), миграции прошли до 12.1.0.0. Затем контейнер вернулся на старый образ 10.11.8 (снапшот от 26.05) — и уже не может стартовать с новой БД.

Питфолл тега latest: docker inspect показывает digest, откуда образ БЫЛ СКАЧАН, а не текущий latest. Локальный «latest» может быть сильно старше, чем latest в реестре. Проверять версию внутри образа: docker run --rm --entrypoint sh jellyfin/jellyfin:latest -c '/jellyfin/jellyfin --version'.

Фикс (ВЫПОЛНЕН 2026-09-20)

Миграцию вручную запустить НЕЛЬЗЯ и не нужно — миграции уже применены (до 12.1.0.0), запускать нечего; даунгрейд схемы EF Core не поддерживает. Проблема не в БД, а в образе контейнера.

# 1) БЭКАП БД (авто-бэкапов нет!)
ssh kraken 'D=/home/kraken/backups/jellyfin-db-$(date +%Y%m%d-%H%M%S); mkdir -p $D; \
  sudo docker cp jellyfin:/config/data/jellyfin.db $D/ && \
  sudo docker cp jellyfin:/config/data/jellyfin.db-wal $D/ 2>/dev/null; \
  sudo chown -R kraken:kraken $D; ls -la $D'

# 2) пересоздать контейнер на актуальном образе
ssh kraken 'cd /srv/dev-disk-by-uuid-6194539b-03e0-4f33-986b-4da09834e82f/docker/jellyfin && \
  sudo docker compose up -d --force-recreate'

# 3) проверка
ssh kraken 'docker exec jellyfin sh -c "/jellyfin/jellyfin --version"'   # ожидаем 12.1.0.0
ssh kraken 'docker ps --format "{{.Names}} {{.Status}}" | grep jelly'    # health: healthy
ssh kraken 'docker exec jellyfin sh -c "curl -s -o /dev/null -w \"%{http_code}\n\" http://localhost:8096/"'

Риск: низкий. Данные (/config) не трогаются, пересоздаётся только контейнер. Бэкап БД обязателен — откатываться больше некуда.

✅ Результат (2026-09-20)

Шаг	Факт
Бэкап БД	/home/kraken/backups/jellyfin-recreate-20260920-165750/ — jellyfin.db (24.5 МБ) + -wal + -shm
Пересоздание	docker compose up -d --force-recreate → Container jellyfin Recreated / Started, rc=0
Статус через 15 с	Up 15 seconds (healthy) — сразу healthy, без периода starting
Подтверждение Alex	«Заработало»

Контейнер теперь работает на образе jellyfin/jellyfin:latest = 12.1.0.0, что согласовано с версией БД. Проблема no such column закрыта.

Compose jellyfin (/srv/.../docker/jellyfin/docker-compose.yml):

image: jellyfin/jellyfin          # без тега = latest
restart: always
ports: ["8096:8096"]
volumes:
  - /srv/.../docker/jellyfin:/config
  - /srv/.../media:/media:ro
environment: [TZ=Asia/Almaty]

Рекомендация на будущее: пинить тег (jellyfin/jellyfin:12.1) вместо latest, иначе watchtower может снова переключить мажорную версию и сломать БД.

Питфоллы диагностики

• docker logs jellyfin не показывает свежий старт — jellyfin пишет в /config/log/log_YYYYMMDD.log, а не в stdout. Читать файл внутри контейнера.
• В контейнере нет sqlite3, python3, strings — БД разбирать только копией на Mac.
• Старые ошибки в логе сбивают: System.UriFormatException: Invalid URI и WS ... closed — это НЕ причина падения, а фон. Искать SqliteException и could not complete startup.
• Проверять --since фильтр осторожно: если контейнер старше, --since 15m даст пусто.

Урок

При no such column в jellyfin (или любом EF Core сервисе) первым делом сравнивать версию бинарника внутри запущенного контейнера с максимальной версией в __EFMigrationsHistory. Версия БД выше версии сервера = откатился образ. Лечится пересозданием контейнера на правильном образе, НЕ правкой БД.