Huidig antwoord: gebruik de mislukte bèta-installatie van 1.4.2 niet als installatiemodel voor Paperless-ngx in 2026
De oorspronkelijke installatie bleef steken op 83% op ZimaOS 1.4.2-beta2. IceWhale gaf aan dat die release de technologie voor de app-installatiebron/proxy had gewijzigd en dat het probleem werd verholpen. Het huidige ZimaOS publiceert nu een speciale installatieprocedure voor Paperless-ngx en het upstream-project heeft een volwassen Docker Compose-traject. Beschouw de vastloper uit 2025 als een historische fout in het installatieprogramma, niet als bewijs dat Paperless-ngx fundamenteel incompatibel is met ZimaOS.
Begin met de huidige configuratie van de ZimaOS App Store
De huidige ZimaOS-instructies gebruiken Paperless-ngx uit de App Store met Aangepaste installatie, zodat je vóór de eerste start het opslagpad, beheerdersgegevens, OCR-talen en waarden voor vertrouwde URL's kunt instellen. De Paperless-installatie voor ZimaOS is momenteel de productspecifieke basis.
De vereisten voor Paperless-ngx helpen bij het bepalen van de juiste capaciteit voordat je grote OCR-taken uitvoert.
Zet persistente gegevens op opslag waarvan je een back-up kunt maken
Paperless heeft verschillende soorten statusgegevens: databasegegevens, applicatiegegevens, media/documenten, geëxporteerde bestanden en de map voor te verwerken bestanden. Houd deze paden persistent buiten de tijdelijke containerlaag. Als je AppData tijdens het debuggen verwijdert, kun je ook de informatie of status verwijderen die nodig is om te begrijpen waarom de vorige installatie mislukte.
De Docker-installatie van Paperless definieert de upstream-services en de aanbevolen PostgreSQL-implementatie.
Begrijp de kwestie rond Tika en Gotenberg
Paperless kan zonder Tika/Gotenberg werken voor de kernverwerking van PDF- en afbeeldingsdocumenten. Tika en Gotenberg zijn optionele services die je gebruikt wanneer je Office-bestanden en e-mails wilt verwerken. Als een pakket een Tika-gerelateerde fout geeft, bepaal dan eerst of je die functie echt nodig hebt voordat je de volledige installatie daarop laat vastlopen.
De Tika-instellingen van Paperless bevat de eindpunten en activeringsvariabelen.
Als de installatie op een percentage blijft steken, bekijk dan de containers in plaats van uren te wachten
docker ps -a
docker logs --tail=200 paperless-webserver
docker logs --tail=200 paperless-db
docker logs --tail=200 paperless-redisDe exacte containernamen zijn afhankelijk van het App Store-pakket. Let op fouten bij het ophalen van images, gereedheid van de database, rechten, CSRF-configuratie of een service die steeds opnieuw wordt gestart. “83%” is een symptoom in de interface; de containerlogs laten zien welk onderdeel faalt.
Herstel het eigenaarschap van de map voor te verwerken bestanden voordat je OCR de schuld geeft
Paperless moet bestanden uit de map voor te verwerken bestanden kunnen lezen en verplaatsen. De upstream Docker-configuratie ondersteunt USERMAP_UID/USERMAP_GID om de rechten op de host op elkaar af te stemmen. Als bestanden in de map op de host verschijnen maar Paperless ze nooit verwerkt, controleer dan het eigenaarschap, het gekoppelde pad en de meldingen van het bestandssysteem.
De vereisten voor ZimaOS-apps helpen voorkomen dat een groeiend documentenarchief op een kleine systeemschijf wordt opgeslagen.
Configureer de externe URL correct
Wanneer Paperless via een ZimaOS-hostadres of reverse proxy wordt benaderd, stel je de vertrouwde origins en de openbare URL in op het adres dat gebruikers daadwerkelijk openen. Een onjuiste originconfiguratie leidt vaak later tot een 403 CSRF-fout, ook al werken alle containers correct.
Maak samen een back-up van de database en documenten
Documentbestanden zonder de Paperless-database verliezen tags, correspondenten, aangepaste velden en de workflowstatus; de database zonder de media verliest de daadwerkelijke documenten. Maak van beide samen één herstelbare eenheid en test een herstelbewerking voordat je grote upgrades uitvoert.
De ZimaOS-back-up biedt de herstel-laag op NAS-niveau.
Veelgestelde vragen
Waarom bleef Paperless-ngx op 83% steken op ZimaOS?
In de oorspronkelijke situatie bracht IceWhale de fout in verband met wijzigingen in de app-bron/proxy van ZimaOS 1.4.2 beta. Controleer op een actueel systeem de containerlogs in plaats van ervan uit te gaan dat dezelfde oude fout opnieuw optreedt.
Heeft Paperless-ngx Tika nodig?
Nee, niet voor het beheer van standaard PDF- en afbeeldingsdocumenten. Tika en Gotenberg zijn optioneel wanneer je Office-documenten en e-mails wilt verwerken.
Waar moet de map voor te verwerken bestanden staan?
Gebruik persistente gegevensopslag van ZimaOS met een duidelijk pad op de host en rechten waarmee de Paperless-container bestanden kan lezen en wijzigen.
Moet ik AppData verwijderen en opnieuw installeren?
Alleen nadat je begrijpt welke gegevens worden verwijderd en een back-up hebt gemaakt. Opnieuw installeren verhelpt geen onjuist volumepad, rechtenprobleem of verkeerde URL-configuratie.
Welke database moet een nieuwe Paperless-installatie gebruiken?
Het upstream-project beveelt momenteel PostgreSQL aan voor nieuwe installaties.
