Jellyfin – Incident SQLite WAL (2026-05-24)

LXC : 20308096
Version : Jellyfin 10.11.9

---

Symptôme

Jellyfin injoignable, forcé de rebooter le LXC depuis PVE.

---

Cause

La tâche planifiée OptimizeDatabaseTask a déclenché un PRAGMA wal_checkpoint(TRUNCATE) en interne.
Le checkpoint s'est bloqué pendant 64 minutes (3 844 360 ms) puis a crashé avec :

System.IndexOutOfRangeException
  at Jellyfin.Database.Implementations.Locking.OptimisticLockBehavior

Bug connu Jellyfin sur SQLite. Le WAL n'a jamais été fusionné → fichier WAL de 25 MB au moment du diagnostic.
La DB elle-même est intègre (PRAGMA integrity_check = ok).

---

Fix appliqué

systemctl stop jellyfin
sqlite3 /var/lib/jellyfin/data/jellyfin.db "PRAGMA wal_checkpoint(TRUNCATE);"
# résultat attendu : 0|0|0
systemctl start jellyfin

---

Prévention

1. Mode journal SQLite → DELETE

Passage du mode WAL au mode DELETE, qui élimine l'accumulation du fichier WAL :

systemctl stop jellyfin
sqlite3 /var/lib/jellyfin/data/jellyfin.db "PRAGMA journal_mode=DELETE;"
systemctl start jellyfin

Vérification (Jellyfin démarré) :

sqlite3 /var/lib/jellyfin/data/jellyfin.db "PRAGMA journal_mode;"
# attendu : delete

Jellyfin 10.11.9 ne force pas le retour en WAL — le mode delete persiste après restart. ✓

2. Cron (root, LXC jellyfin)

10 12 * * *  /usr/bin/systemctl reboot

Reboot quotidien à 12h10. La ligne de checkpoint WAL a été supprimée (inutile en mode DELETE).

3. UI Jellyfin

Dashboard → Tâches planifiées → Optimize Database → déclencheur automatique désactivé.

---

Fichiers concernés

Avant (au moment du crash)

Fichier	Taille	Notes
jellyfin.db	1.9 GB	DB principale, intègre
jellyfin.db-wal	25 MB	WAL bloqué, non fusionné
jellyfin.db-shm	64 KB	Shared memory WAL

Après (solution appliquée)

Fichier	Taille	Notes
jellyfin.db	1.9 GB	Inchangée
jellyfin.db-wal	—	Absent (mode DELETE)
jellyfin.db-shm	—	Absent (mode DELETE)