Denna handledning från december 2025 är en av de mer detaljerade community-guiderna för Paperless-ngx på ZimaOS, men den är knuten till ett specifikt BigBear-paket och ZimaOS 1.5.3 Plus. Det som är beständigt är lagrings- och konfigurationskoncepten: ge consume-mappen en tydlig beständig plats, ställ in program-URL:en korrekt, konfigurera OCR-språk och förstå valfria Tika-/Gotenberg-tjänster.
Vissa källdetaljer behöver en aktuell avgränsning. Paperless-ngx:s uppströmsbaserade Docker-installation har utvecklats, PostgreSQL rekommenderas nu för nya installationer, aktuella Compose-filer frågar efter en superanvändare vid den första konfigurationen, och Tika/Gotenberg är fortfarande valfria snarare än obligatoriska för alla dokumentarbetsflöden.
Källhandledningen testades på en enklare ZimaBoard 2
Författaren dokumenterade ett N150-baserat system med 16 GB RAM som körde ZimaOS 1.5.3 Plus. Målet var åtkomst via lokalt nätverk eller Tailscale för hemmabruk, inte direkt exponering mot internet.
Den avgränsningen är viktig eftersom en driftsättning på det publika internet kräver en annan plan för HTTPS, omvänd proxy, autentisering och säkerhet.
Guiden använde BigBear Paperless-ngx anpassad installation
Källans arbetsflöde sökte i App Store efter BigBear Paperless-ngx-paketet, öppnade installationsmenyn och valde Anpassad installation så att volymer och miljövärden kunde redigeras före första starten.
Det är ett paketspecifikt arbetsflöde. En aktuell appdefinition kan lägga till, ta bort eller byta namn på tjänster och variabler.
Ge consume-katalogen en tydlig beständig sökväg på värden
/usr/src/paperless/consume som mapp som användare troligast interagerar med när de lägger in dokument.Den aktuella uppströmsdokumentationen för Paperless använder fortfarande /usr/src/paperless/consume som standarddestination för containern och stöder uttryckligen ändring av värdsidan för denna bindmontering.
Handledningen ställde in administratörs-, konsument-, OCR- och URL-variabler
Viktiga källval omfattade:
- anpassat administratörsnamn och lösenord;
- rekursiv dokumentimport;
- radering av original från consume-mappen efter lyckad import;
- OCR-rensning och språkinställningar;
- betrodd CSRF-ursprung och program-URL;
- Tika-/Gotenberg-slutpunkter.
PAPERLESS_URL och CSRF Origins måste matcha hur du faktiskt använder Paperless
I handledningen varnades det för att felaktig URL-/origin-konfiguration kunde orsaka ett 403-fel vid CSRF-verifiering. Det är fortfarande principiellt korrekt.
Den aktuella dokumentationen för Paperless anger PAPERLESS_URL ska ställas in när applikationen körs bakom en omvänd proxy och ska motsvara den externt använda domänen/URL:en. Hårdkoda inte källförfattarens LAN-adress i en annan installation.
OCR-inställningarna justerades också inuti Paperless
OCR-språken måste motsvara de språkpaket som finns tillgängliga i containern. Att lägga till språk kan öka avbildens storlek eller ändra kraven för rootless-containrar beroende på det aktuella paketet.
Omstart efter varje stor batch i Consume-mappen är ett råd från källan, inte ett krav från upstream
Den aktuella versionen av Paperless-ngx är utformad för att kontinuerligt övervaka Consume-katalogen. Upstream-dokumentationen anger inte att stora batcher normalt kräver en omstart. Om dokument slutar behandlas bör du i stället kontrollera behörigheter, konsumentloggar, stöd för filsystemaviseringar samt tillståndet för broker och worker, i stället för att göra omstart till en obligatorisk rutin.
Den aktuella upstream-konfigurationen rekommenderar PostgreSQL för nya installationer
Den aktuella Docker-konfigurationen för Paperless-ngx rekommenderar PostgreSQL för nya installationer, även om SQLite och MariaDB fortfarande är tillgängliga i konfigurationer som stöds.
För ett långsiktigt dokumentarkiv är den aktuella Compose-topologin från upstream en bättre referens än att anta att exakt samma BigBear-databastjänst från 2025 fortfarande används.
Tika och Gotenberg är valfria
Den aktuella dokumentationen för Paperless anger att Tika och Gotenberg behövs för att tolka Office-dokument som DOC/XLSX/ODT och e-postfiler. Om du endast importerar format som hanteras av Paperless-kärnan kan funktionen förbli inaktiverad.
Använd den aktuella Docker-konfigurationen för Paperless-ngx innan du manuellt återskapar den historiska BigBear-stacken.
Behörigheter för Consume-mappen är viktigare än upprepade omstarter
Den aktuella upstream-konfigurationen visar USERMAP_UID och USERMAP_GID så att containern kan skriva till bind-monteringar på värden. Om Paperless ser en consume-mapp men inte kan bearbeta eller ta bort filer bör du kontrollera ägarskapet för den mapp som mappats och containerns identitet.
På ZimaOS bör du även kontrollera att consume-sökvägen på värden finns på den avsedda hanterade lagringen och inte är en skrivskyddad volymmappning.
Att ta bort original från /consume är inte samma sak som att ta bort arkiverade dokument
Källan aktiverade PAPERLESS_CONSUMER_DELETE_ORIGINALS=true. Detta styr vad som händer med indatafilen i consume-katalogen efter lyckad import. Det arkiverade dokumentet som hanteras av Paperless finns kvar i dess medielagring.
Testa detta beteende med dokument som kan kasseras innan du pekar en automatiserad skanner eller synktjänst mot en produktionsmapp.
Svaren om Paperless-AI gäller en separat integration
Senare svar diskuterade hur Paperless-AI läser dokument via Paperless API men misslyckas med att analysera och skriva taggar med den inbyggda OpenAI-konfigurationen. Användare rapporterade att Mistral fungerade och att manuell OpenAI-konfiguration kringgick problemet.
Dessa svar bevisar inte att den grundläggande Paperless-ngx-installationen är trasig. Paperless-AI är en separat tredjepartsintegration med egen konfiguration av leverantör och API.
Senare 500-fel och lösenordsfrågor löstes inte i tråden
En användare rapporterade i februari 2026 HTTP 500 vid uppladdning, och en annan användare kunde i maj 2026 inte få de förväntade lösenorden att fungera. Den offentliga tråden innehåller inga slutgiltiga diagnoser för dessa fall.
Gör inte om originalhandledningens exempeluppgifter till ett universellt inloggningsrecept för senare BigBear-versioner.
Exportera Paperless-data före större paketändringar
Den aktuella versionen av Paperless har en dokumentexportör som inkluderar dokument, miniatyrbilder, metadata och databashärledd information för migrerings- och säkerhetskopieringsarbetsflöden. Använd en programmedveten export tillsammans med vanliga lagringssäkerhetskopior innan du ersätter databasen eller Compose-stacken.
Vanliga frågor om Paperless-ngx på ZimaOS
Krävs Tika för alla Paperless-ngx-installationer?
Nej. Det är valfritt och behövs främst för Office-dokument och e-posttolkning.
Kräver stora consume-batcher normalt en omstart?
Källförfattaren rekommenderade det utifrån sin erfarenhet, men den aktuella uppströmsdokumentationen anger inte att omstart normalt krävs.
Vilken databas rekommenderar den aktuella versionen av Paperless för nya installationer?
PostgreSQL är den rekommenderade backend-lösningen för nya Docker-distributioner.
Ingår Paperless-AI i själva Paperless-ngx?
Nej. Det är en separat tredjepartsintegration som diskuteras senare i tråden.
