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 De YAML uit de bron startte BookLore succesvol op ZimaOS en is waardevol als bewijs dat een stack met twee services — BookLore plus MariaDB — op het platform werkt. Toch moet deze vandaag niet ongewijzigd worden gekopieerd. De onderhouden implementatie van BookLore gebruikt nu bijgewerkte imagenamen, een duidelijker DISK_TYPE.
De bron bevestigt dat de BookLore-webservice zelf op ZimaOS werkte.
De bron gebruikte BookLore plus MariaDB
In de YAML werden twee services op een privé-Dockernetwerk aangemaakt: BookLore op poort 6060 en een MariaDB-container van LinuxServer. Ook werden applicatiegegevens, boeken, BookDrop en de MariaDB-configuratie aan persistente hostmappen gekoppeld.
De wachtwoorden uit de bron niet opnieuw gebruiken wachtwoord voor het BookLore-databasewachtwoord en het MariaDB-rootwachtwoord. Die waarden zijn openbare voorbeelden en geen veilige inloggegevens.
De huidige upstream-richtlijnen verplaatsen geheimen naar een .env bestand en wordt verwacht dat gebruikers hun eigen waarden kiezen.
Huidige upstream gebruikt de image-namespace booklore-app
In de huidige BookLore-documentatie staat ghcr.io/booklore-app/booklore:latest als de hoofdimage en blijft een service op basis van MariaDB 11.4 gebruiken.
Gebruik de huidige implementatiehandleiding van BookLore in plaats van de image-tags van februari 2026 vast te zetten.
Houd gegevens, boeken, BookDrop en databaseopslag gescheiden
De huidige BookLore-configuratie gebruikt persistente koppelingen voor:
-
/app/data— applicatiegegevens en cache met metagegevens; -
/books— de beheerde bibliotheek; -
/bookdrop— automatische import-/dropmap; - MariaDB-opslag/configuratie — de databasestatus.
Grote bibliotheken niet standaard op ZimaOS-HD plaatsen
De bron combineerde /media/ZimaOS-HD/AppData en /DATA/AppData. De huidige aanbeveling van ZimaOS is om applicatiegegevens en bibliotheken op een echte opslagpool te bewaren in plaats van de systeemschijf te vullen.
Controleer USER_ID en GROUP_ID in plaats van 1000 aan te nemen
In de bron was UID/GID 1000 hardgecodeerd. Dat kan in één omgeving werken, maar bij huidige containers en hostmappen moeten de daadwerkelijke eigenaars en machtigingen van de gekozen opslagpaden worden gecontroleerd.
Huidige Compose voegt een healthcheck voor BookLore toe
Moderne upstream Compose bevat een HTTP-healthcheck voor BookLore en een afhankelijkheid van de database-status. Dat zorgt voor beter opstartgedrag dan beide containers alleen starten en hopen dat MariaDB op tijd gereed is.
Het mobiele probleem van de bron was geen mislukte installatie op ZimaOS
De auteur zei dat de webinterface goed was, maar dat pogingen om via mobiel verbinding te maken met Komga-compatibiliteit niet succesvol waren. Later zei de auteur dat MoonReader via OPDS werkte.
Dat moet worden gediagnosticeerd als een compatibiliteitsprobleem tussen BookLore en de client, niet als bewijs dat de BookLore-server zelf is mislukt.
OPDS past beter bij veel leesapps
Huidige versies van BookLore leggen naast lezen via het web en bibliotheekbeheer ook de nadruk op OPDS. Als een mobiele app OPDS ondersteunt, gebruik dan het huidige OPDS-eindpunt van BookLore en een geverifieerde gebruiker in plaats van een Komga-compatibiliteitslaag te forceren.
Maak een back-up van zowel de database als de bibliotheek
De database bevat metagegevens, gebruikers, planken, leesstatus en configuratie; de map met boeken bevat de daadwerkelijke bestanden. Een back-upplan moet beide beschermen.
Huidige versies van BookLore onderscheiden LOCAL- en NETWORK-opslag
Moderne versies van BookLore bevatten een DISK_TYPE instelling. LOCAL is de normale modus wanneer BookLore bestanden rechtstreeks kan beheren. NETWORK is bedoeld voor opslag in NFS-/SMB-stijl en schakelt sommige bewerkingen voor het reorganiseren van bestanden uit.
Kies de modus op basis van waar de bibliotheek is gekoppeld, in plaats van de YAML uit de bron te kopiëren zonder rekening te houden met dit nieuwere gedrag.
BookDrop is een importinbox, niet de canonieke bibliotheek
De /bookdrop map is bedoeld voor bestanden die je door BookLore wilt laten opnemen. Houd deze gescheiden van /books zodat geautomatiseerde imports het onderscheid tussen nieuwe binnenkomende bestanden en de beheerde bibliotheek niet vertroebelen.
Maak een consistente back-up van MariaDB
Het kopiëren van een actieve databasemap is niet altijd gelijkwaardig aan een consistente databaseback-up. Gebruik voor belangrijke bibliotheken een MariaDB-bewuste dump of stop de database netjes voordat je een back-up op bestandsniveau maakt en controleer daarna de herstelprocedures.
Versies vastzetten of controleren vóór automatische updates
De bron gebruikte nieuwste voor BookLore. Dat is handig, maar een toekomstige pull kan onverwacht wijzigingen in de applicatie of database introduceren. Als stabiliteit belangrijk is, bekijk dan de releaseopmerkingen van de upstreamversie en maak een back-up van de database voordat je de stack opnieuw aanmaakt met een nieuwere image.
Veelgestelde vragen over BookLore op ZimaOS
Is BookLore met de YAML uit de bron succesvol gestart?
Ja. De auteur plaatste een werkend BookLore-dashboard.
Moeten de openbare wachtwoordwaarden uit de bron opnieuw worden gebruikt?
Nee. Genereer unieke BookLore- en MariaDB-inloggegevens.
Welke mobiele methode werkte voor de auteur van de bron?
Ze meldden dat MoonReader via OPDS werkte, terwijl hun pogingen met Komga-compatibiliteit niet succesvol waren.
