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 Källans YAML-fil startade BookLore framgångsrikt på ZimaOS och är ett värdefullt bevis på att en BookLore- och MariaDB-stack med två tjänster fungerar på plattformen. Men den bör inte kopieras oförändrad i dag. BookLores underhållna distribution använder nu uppdaterade bildnamn, en tydligare DISK_TYPE.
Källan bekräftar att själva BookLore-webbtjänsten fungerade på ZimaOS.
Källan använde BookLore plus MariaDB
YAML-filen skapade två tjänster i ett privat Docker-nätverk: BookLore på port 6060 och en MariaDB-container från LinuxServer. Den mappade också programdata, böcker, BookDrop och MariaDB-konfiguration till beständiga mappar på värden.
Återanvänd inte källans lösenord password för BookLore-databasens lösenord och MariaDB:s root-lösenord. Dessa värden är offentliga exempel och inga säkra autentiseringsuppgifter.
Aktuella instruktioner uppifrån flyttar hemligheter till en .env fil och förväntar sig att användarna väljer sina egna värden.
Aktuell uppströmsversion använder namnrymden booklore-app för avbildningar
Aktuell BookLore-dokumentation anger ghcr.io/booklore-app/booklore:latest som huvudbild och fortsätter att använda en tjänst baserad på MariaDB 11.4.
Använd den aktuella distributionsguiden för BookLore i stället för att låsa fast bildtaggarna från februari 2026.
Håll data, böcker, BookDrop och databasen åtskilda
Aktuella BookLore använder beständiga mappningar för:
-
/app/data— programdata och cache för metadata; -
/books— det hanterade biblioteket; -
/bookdrop— automatisk import-/släppmapp; - MariaDB-lagring/-konfiguration — databastillståndet.
Använd inte ZimaOS-HD som standard för stora bibliotek
Källan blandade /media/ZimaOS-HD/AppData och /DATA/AppData. Aktuella ZimaOS rekommenderar att programdata och bibliotek sparas på en riktig lagringspool i stället för att fylla systemdisken.
Verifiera USER_ID och GROUP_ID i stället för att anta 1000
Källan hade UID/GID 1000 hårdkodat. Det kan fungera i en miljö, men aktuella containrar och värdmappar bör kontrolleras mot det faktiska ägarskapet och behörigheterna för de valda lagringssökvägarna.
Aktuell Compose lägger till en hälsokontroll för BookLore
Modern upstream-Compose innehåller en HTTP-hälsokontroll för BookLore och ett beroende av databasens hälsostatus. Det ger ett bättre startförlopp än att bara starta båda containrarna och hoppas att MariaDB hinner bli redo.
Källans mobilproblem berodde inte på ett installationsfel i ZimaOS
Författaren sade att webbgränssnittet var bra, men att försöken att ansluta mobiler med Komga-kompatibilitet misslyckades. Senare sade de att MoonReader fungerade via OPDS.
Det bör diagnostiseras som kompatibilitet mellan BookLore och klientens protokoll, inte som ett bevis på att själva BookLore-servern har misslyckats.
OPDS passar bättre för många läsappar
Aktuella versioner av BookLore betonar OPDS vid sidan av webbläsning och bibliotekshantering. Om en mobilapp stöder OPDS bör du använda BookLores aktuella OPDS-slutpunkt och en autentiserad användare i stället för att tvinga fram ett Komga-kompatibilitetslager.
Säkerhetskopiera både databasen och biblioteket
Databasen innehåller metadata, användare, hyllor, lässtatus och konfiguration; bokmappen innehåller de faktiska filerna. En säkerhetskopieringsplan bör skydda båda.
Aktuella versioner av BookLore skiljer mellan lokal och nätverksbaserad lagring
Moderna versioner av BookLore innehåller en DISK_TYPE inställningen. LOCAL är det normala läget när BookLore kan hantera filer direkt. NETWORK är avsett för NFS-/SMB-liknande lagring och inaktiverar vissa åtgärder för filomorganisation.
Välj läge utifrån var biblioteket är monterat i stället för att kopiera källans YAML utan att ta hänsyn till detta nyare beteende.
BookDrop är en importinkorg, inte det kanoniska biblioteket
Den /bookdrop mappen är avsedd för filer som du vill att BookLore ska importera. Håll den åtskild från /books så att automatiserade importer inte suddar ut skillnaden mellan nya inkommande filer och det hanterade biblioteket.
Säkerhetskopiera MariaDB konsekvent
Att kopiera en aktiv databaskatalog är inte alltid likvärdigt med en konsekvent säkerhetskopia av databasen. För viktiga bibliotek bör du använda en MariaDB-anpassad dump eller stoppa databasen korrekt före säkerhetskopiering på filsystemnivå och sedan verifiera rutinerna för återställning.
Lås eller granska versionerna före automatiska uppdateringar
Källan använde senaste för BookLore. Det är praktiskt, men en framtida hämtning kan oväntat införa ändringar i programmet eller databasen. Om stabilitet är viktigt bör du läsa versionsanteckningarna uppströms och säkerhetskopiera databasen innan du återskapar stacken med en nyare avbild.
Vanliga frågor om BookLore på ZimaOS
Startade källans YAML-konfiguration BookLore utan problem?
Ja. Författaren publicerade en fungerande BookLore-instrumentpanel.
Bör de offentliga lösenordsvärdena från källan återanvändas?
Nej. Skapa unika inloggningsuppgifter för BookLore och MariaDB.
Vilken mobil lösning fungerade för källans författare?
De rapporterade att MoonReader fungerade via OPDS, medan deras försök att använda Komga-kompatibilitet misslyckades.
