Aktuellt svar: Använd inte installationsfelet i betaversion 1.4.2 som modell för Paperless-ngx-installationer 2026
Den ursprungliga installationen stannade vid 83 % på ZimaOS 1.4.2-beta2, och IceWhale uppgav att den versionen hade ändrat tekniken för appinstallationskälla/proxy samt att problemet höll på att åtgärdas. Aktuella ZimaOS publicerar nu en särskild installationsprocedur för Paperless-ngx, och uppströmsprojektet har en mogen Docker Compose-lösning. Betrakta stoppet 2025 som ett historiskt installationsfel, inte som bevis på att Paperless-ngx är fundamentalt inkompatibelt med ZimaOS.
Börja med den aktuella konfigurationen i ZimaOS App Store
Aktuella ZimaOS-instruktioner använder Paperless-ngx från App Store med anpassad installation, så att du kan ange lagringssökväg, administratörsuppgifter, OCR-språk och betrodda URL-värden innan första starten. ZimaOS-konfigurationen för Paperless är den aktuella produktspecifika utgångspunkten.
Kraven för Paperless-ngx hjälper dig att dimensionera appen inför omfattande OCR-jobb.
Placera beständiga data på lagring som du kan säkerhetskopiera
Paperless har flera typer av tillstånd: databasedata, programdata, media/dokument, exporterade filer och consume-mappen. Håll dessa sökvägar beständiga och utanför det tillfälliga containerlagret. Om du tar bort AppData under felsökning kan du även radera bevis eller tillstånd som behövs för att förstå varför den tidigare installationen misslyckades.
Paperless Docker-konfigurationen definierar uppströms tjänster och rekommenderad PostgreSQL-distribution.
Förstå frågan om Tika och Gotenberg
Paperless kan köras utan Tika/Gotenberg för sitt grundläggande flöde för PDF- och bilddokument. Tika och Gotenberg är valfria tjänster som används när du vill hantera Office-filer och e-posttolkning. Om ett paket får ett Tika-relaterat fel bör du först avgöra om du faktiskt behöver funktionen, innan du låter den blockera hela installationen.
Paperless Tika-inställningarna listar slutpunkterna och aktiveringsvariablerna.
Om installationen stannar vid en procentsats, övervaka containrarna i stället för att vänta i timmar
docker ps -a
docker logs --tail=200 paperless-webserver
docker logs --tail=200 paperless-db
docker logs --tail=200 paperless-redisDe exakta containernamnen beror på App Store-paketet. Leta efter misslyckad hämtning av avbildning, problem med databasens beredskap, behörigheter, CSRF-konfiguration eller en tjänst som fastnar i omstart. ”83 %” är ett symptom i gränssnittet; containerloggarna identifierar den felande komponenten.
Åtgärda ägarskapet för consume-mappen innan du skyller på OCR
Paperless måste kunna läsa och flytta filer från consume-katalogen. Uppströms Docker-konfiguration stöder USERMAP_UID/USERMAP_GID för anpassning av värdbehörigheter. Om filer visas i värdens consume-mapp men Paperless aldrig bearbetar dem bör du kontrollera ägarskap, monteringssökväg och filsystemshändelser.
ZimaOS appkrav hjälper dig att undvika att placera ett växande dokumentarkiv på en liten OS-enhet.
Konfigurera den externa URL:en korrekt
När Paperless nås via en ZimaOS-värdadress eller omvänd proxy ska du ange betrodda ursprung och offentlig URL till den adress som användarna faktiskt öppnar. En felaktig ursprungskonfiguration visar sig ofta senare som ett 403 CSRF-fel, trots att alla containrar fungerar.
Säkerhetskopiera databasen och dokumenten tillsammans
Dina dokumentfiler utan Paperless-databasen förlorar taggar, korrespondenter, anpassade fält och arbetsflödestillstånd; databasen utan media saknar själva dokumenten. Säkerhetskopiera båda som en gemensam återställningsenhet och testa en återställning före större uppgraderingar.
ZimaOS-säkerhetskopieringen tillhandahåller återställningslagret på NAS-nivå.
Vanliga frågor
Varför stannade Paperless-ngx vid 83 % på ZimaOS?
I det ursprungliga fallet kopplade IceWhale felet till ändringar av appkälla/proxy i betaversionen av ZimaOS 1.4.2. På ett aktuellt system bör du granska containerloggarna i stället för att anta att samma gamla fel gäller.
Kräver Paperless-ngx Tika?
Nej, inte för grundläggande hantering av PDF- och bilddokument. Tika och Gotenberg är valfria när du behöver tolka Office-dokument och e-post.
Var bör consume-mappen ligga?
Använd beständig ZimaOS-datalagring med en tydlig värdsökväg och behörigheter som gör att Paperless-containern kan läsa och ändra filer.
Bör jag ta bort AppData och installera om?
Endast efter att du har förstått vilka data som tas bort och har en säkerhetskopia. En ominstallation åtgärdar inte en felaktig volymsökväg, behörighet eller URL-konfiguration.
Vilken databas bör en ny Paperless-installation använda?
Uppströmsprojektet rekommenderar för närvarande PostgreSQL för nya installationer.
