The source YAML successfully launched BookLore on ZimaOS and is valuable as a proof that a two-service BookLore + MariaDB stack works on the platform. But it should not be copied unchanged today. BookLore's maintained deployment now uses updated image names, a clearer .env Le fichier YAML source a lancé BookLore avec succès sur ZimaOS et constitue une preuve utile qu’une pile BookLore + MariaDB à deux services fonctionne sur la plateforme. Cependant, il ne faut pas le copier tel quel aujourd’hui. Le déploiement maintenu de BookLore utilise désormais des noms d’images mis à jour, un DISK_TYPE.
La source confirme que le service web BookLore lui-même fonctionnait sur ZimaOS.
La source utilisait BookLore avec MariaDB
Le fichier YAML créait deux services sur un réseau Docker privé : BookLore sur le port 6060 et un conteneur MariaDB LinuxServer. Il mappait également les données de l’application, les livres, BookDrop et la configuration de MariaDB vers des dossiers persistants de l’hôte.
Ne réutilisez pas les mots de passe de la source mot de passe pour le mot de passe de la base de données BookLore et le mot de passe root de MariaDB. Ces valeurs sont des exemples publics et ne constituent pas des identifiants sûrs.
Les recommandations actuelles en amont déplacent les secrets dans un .env le fichier et attend des utilisateurs qu’ils choisissent leurs propres valeurs.
La version actuelle en amont utilise l’espace de noms d’images booklore-app
La documentation actuelle de BookLore répertorie ghcr.io/booklore-app/booklore:latest comme image principale et continue d’utiliser un service basé sur MariaDB 11.4.
Utilisez le guide de déploiement actuel de BookLore plutôt que de figer les balises d’image de février 2026.
Séparez le stockage des données, des livres, de BookDrop et de la base de données
La version actuelle de BookLore utilise des mappages persistants pour :
-
/app/data— données de l’application et cache des métadonnées ; -
/books— bibliothèque gérée ; -
/bookdrop— dossier d’importation/de dépôt automatique ; - Stockage/configuration de MariaDB — l’état de la base de données.
Ne définissez pas par défaut les grandes bibliothèques sur ZimaOS-HD
La source mélangeait /media/ZimaOS-HD/AppData et /DATA/AppData. ZimaOS recommande actuellement de conserver les données des applications et les bibliothèques sur un véritable pool de stockage plutôt que de remplir le disque système.
Vérifiez USER_ID et GROUP_ID au lieu de supposer la valeur 1000
Le fichier source définissait en dur l’UID/GID 1000. Cela peut fonctionner dans un environnement, mais les conteneurs actuels et les dossiers de l’hôte doivent être vérifiés en fonction du propriétaire et des autorisations réels des chemins de stockage choisis.
La version actuelle de Compose ajoute une vérification de santé pour BookLore
Compose en amont moderne inclut une vérification de santé HTTP pour BookLore ainsi qu’une dépendance liée à l’état de santé de la base de données. Cela offre un meilleur comportement au démarrage que de simplement lancer les deux conteneurs en espérant que MariaDB soit prête à temps.
Le problème mobile de la source n’était pas un échec de l’installation de ZimaOS
L’auteur a indiqué que l’interface Web était bonne, mais que les tentatives de connexion mobile compatibles avec Komga avaient échoué. Il a ensuite indiqué que MoonReader fonctionnait via OPDS.
Cela doit être diagnostiqué comme un problème de compatibilité entre BookLore et le client ou le protocole, et non comme la preuve que le serveur BookLore lui-même a échoué.
OPDS convient mieux à de nombreuses applications de lecture
Les versions actuelles de BookLore mettent l’accent sur OPDS, en complément de la lecture sur le Web et de la gestion de la bibliothèque. Si une application mobile prend en charge OPDS, utilisez le point de terminaison OPDS actuel de BookLore et un utilisateur authentifié plutôt que de forcer une couche de compatibilité avec Komga.
Sauvegardez à la fois la base de données et la bibliothèque
La base de données contient les métadonnées, les utilisateurs, les étagères, l’état de lecture et la configuration ; le dossier des livres contient les fichiers réels. Un plan de sauvegarde doit protéger les deux.
Les versions actuelles de BookLore distinguent le stockage LOCAL du stockage NETWORK
Les versions modernes de BookLore incluent un DISK_TYPE paramètre. LOCAL est le mode normal lorsque BookLore peut gérer directement les fichiers. NETWORK est destiné au stockage de type NFS/SMB et désactive certaines opérations de réorganisation des fichiers.
Choisissez le mode en fonction de l’emplacement de montage de la bibliothèque plutôt que de copier le fichier YAML source sans tenir compte de ce comportement plus récent.
BookDrop est une boîte de réception pour les importations, pas la bibliothèque canonique
Le /bookdrop Le dossier est conçu pour les fichiers que vous souhaitez faire ingérer par BookLore. Gardez-le séparé de /books afin que les importations automatisées ne brouillent pas la distinction entre les nouveaux fichiers entrants et la bibliothèque gérée.
Sauvegardez MariaDB de manière cohérente
Copier un répertoire de base de données actif n’équivaut pas toujours à effectuer une sauvegarde cohérente de la base de données. Pour les bibliothèques importantes, utilisez un export compatible avec MariaDB ou arrêtez proprement la base de données avant une sauvegarde au niveau du système de fichiers, puis vérifiez les procédures de restauration.
Épinglez les versions ou vérifiez-les avant les mises à jour automatiques
La source utilisait latest pour BookLore. C’est pratique, mais une future récupération peut introduire de manière inattendue des changements dans l’application ou la base de données. Si la stabilité est importante, consultez les notes de version en amont et sauvegardez la base de données avant de recréer la pile avec une image plus récente.
FAQ BookLore sur ZimaOS
Le fichier YAML de la source a-t-il démarré BookLore correctement ?
Oui. L’auteur a publié un tableau de bord BookLore fonctionnel.
Faut-il réutiliser les valeurs publiques des mots de passe de la source ?
Non. Générez des identifiants uniques pour BookLore et MariaDB.
Quelle solution mobile a fonctionné pour l’auteur de la source ?
Ils ont indiqué que MoonReader fonctionnait via OPDS, tandis que leurs tentatives compatibles avec Komga avaient échoué.
