mrkeyoor.com_
Sat 31 Oct 13:12 UTC
Self-Hostedevaluationupdated 31 Oct 2026

paperless-ngx review

Choose Paperless-ngx for a searchable document archive you can host and maintain yourself. Paperless-ngx turns physical documents into a searchable online archive. Its README warns against running it on an untrusted host because information is stored in clear text without encryption. Our run on 2026-08-24 at commit 2609327 stopped during test setup; it did not establish that document ingestion, OCR or retrieval worked.

+303stars / 7d
Verdict

Evaluate Paperless-ngx if you want to host a searchable archive and accept responsibility for trusted storage and backups. Our dated sandbox run established installation success and a secret-key configuration failure during test setup; it did not establish a working document workflow. Configure a disposable deployment and verify import, retrieval and restoration before moving sensitive records into it. Choose another approach if application-level encryption or managed operation is a requirement.

We ran it

Lab card: what happened when we ran paperless-ngxScreenshot of paperless-ngx (docs.paperless-ngx.com)
Install✓ · 83s216 packages · 1456 MB
Build✓ · 6s
Tests✗ · 9sran, no count parsed
Known vulns0(pip-audit)
Repo1492 files~195,077 lines of source · 114.5 MB · 14 CI workflows · Dockerfile

Answers from our run

Does paperless-ngx build from source?

Dependencies installed in 83 seconds (216 packages), and the build succeeded in 6 seconds. We cloned commit 2609327 into a clean Debian container with 3 CPUs and no project-specific setup.

Do paperless-ngx's tests pass?

No. The project's own test command exited unsuccessfully after 9 seconds, and its output did not expose an individual test count.

Does paperless-ngx have known vulnerabilities in its dependencies?

pip-audit found none in the dependency tree at the time of our run.

Who should not use paperless-ngx?

Anyone who requires the application itself to encrypt stored documents.

What are the alternatives to paperless-ngx?

Docspell, Papermerge OSS. Evaluate Paperless-ngx if you want to host a searchable archive and accept responsibility for trusted storage and backups.

Setup3/5The README documents a Compose route, but our source-checkout tests stopped on secret-key configuration. Under the visible rubric, this is a documented route with unresolved setup work.
DocsN/AThe documentation and setup pages could not be independently retrieved, so their completeness and accuracy cannot be assessed from the README alone.
CommunityN/AThe README names GitHub and Matrix support channels, but the supplied evidence does not establish response quality, participation or maintenance cadence.
MaturityN/ASuccessor status and one configuration-blocked sandbox run do not establish production reliability, upgrade safety or successful recovery.

Discussed on

  1. hnPaperless-ngx – Open source document management system627 points
  2. hnPaperless-Ngx v2.0.0182 points
  3. hnPaperless-NGX169 points
  4. hnPaperless-ngx: scan, index and archive all your physical documents46 points
  5. hnShow HN: I built a receipt processor for Paperless-ngx6 points

Who it’s for

Households willing to maintain a local document server and backups.
Operators evaluating a searchable archive who can configure and validate the deployment before importing sensitive records.
Existing Paperless-ng users considering its official successor, with migration guidance to review before proceeding.

Who it’s NOT for

Anyone who requires the application itself to encrypt stored documents.
Readers seeking a managed service that removes responsibility for hosting and backups.
Teams requiring demonstrated OCR accuracy, ingestion reliability or production readiness from this review: our sandbox did not establish those outcomes.

Setup reality

Our sandbox run on 2026-08-24 tested commit 2609327. The stored harness record reports an 83-second installation, 216 installed packages and a 1,456 MB dependency footprint. The install step returned exit 0, and the recorded build step returned exit 0 after 6 seconds. Neither result proves that a working document service was deployed.

The test command returned exit 4 after 9 seconds while loading Django settings. The log identifies PAPERLESS_SECRET_KEY as unset or still using the default value. There are no recorded test counts, so this run provides no passing-test total or coverage assessment.

The README recommends Docker Compose as the easiest deployment route. Our source-checkout results do not validate that route. Before importing real records, configure the service, use a unique secret key, and verify ingestion, search and recovery with disposable documents.

Should you trust it with your archive?

Paperless-ngx is worth evaluating if you want a searchable archive on a server you control and can maintain backups. Its README explicitly recommends a local server with backups and warns that stored information is not encrypted. That storage boundary matters before any discussion of installation speed.

Our run on 2026-08-24 at commit 2609327 reached a configuration error during test setup. We did not validate a running archive, OCR accuracy, document ingestion, search results, permissions, backup restoration or an upgrade. Treat the recorded command outcomes as setup evidence, then test the document workflow you need before committing your records.

What our sandbox actually established

The attached record identifies a Python sandbox using ghcr.io/astral-sh/uv:python3.12-bookworm with 3 CPUs and 8 GB of memory. Installation succeeded in 83 seconds, with 216 packages and a recorded dependency footprint of 1,456 MB. The build step returned exit 0 after 6 seconds, but its stored log tail is empty. That limits what we can say about the work it performed.

The test setup stopped because PAPERLESS_SECRET_KEY was unset or still set to change-me. The command returned exit 4 after 9 seconds while pytest loaded configuration through Django. This is a configuration failure before recorded test results, rather than evidence that document-processing assertions failed. The stored test-count field is null.

The harness records each command's success flag, elapsed time, exit code, timeout status and log tail. Those fields let us distinguish an installation success from a test setup failure. The supplied MrKeyoor testing methodology explains this reporting approach and its limits; its current description does not establish which procedure version was used for our August run. This correction uses the existing record and includes no new execution.

The stored pip-audit result reports zero advisories. Scan coverage is unknown: the record supplies no scannedPackages value, and its separate packages field is zero. The audit result does not establish that all 216 installed packages were scanned or that the application is secure.

Deployment still needs its own check

The commit-matched README calls Docker Compose the easiest way to deploy Paperless-ngx and links an installation script. That recommendation comes from the project; our sandbox did not demonstrate a Compose deployment.

For an initial evaluation, use disposable documents and check that you can import them, find their contents and restore them from a backup. Resolve the secret-key configuration before rerunning tests. Keep these checks separate: a passing source test suite would still leave your storage, access and recovery configuration to validate.

The supplied documentation and setup pages could not be independently retrieved. This review therefore does not rely on their detailed claims about supported formats, OCR languages, optional services, database recommendations or AI features. The supplied README establishes the archive's purpose and deployment recommendation, but our run does not measure its document-processing quality.

Which alternatives deserve a look?

Docspell can unify files from scanners, emails and other sources. Its README also describes OCR, full-text search and suggested metadata. Evaluate it as a replacement archive if assisted classification and email ingestion are central to your requirements. These are documented capabilities, not results from our sandbox, and they do not establish that Docspell performs better than Paperless-ngx.

Papermerge OSS supports OCR, full-text search, tags and hierarchical folders. Evaluate it as a replacement if organizing scanned documents through folders and a desktop-like browser is your preferred workflow. Its README distinguishes the self-hosted OSS edition from Papermerge Cloud, which has a separate codebase; do not assume their features match.

The supplied Paperless-GPT page addresses an add-on that connects to Paperless-ngx for metadata suggestions and OCR-related work. It answers a different question from choosing the underlying archive and belongs in the complement category.

How to read the ratings

Assessed ratings use a five-point rubric: 1 means the supplied evidence shows a substantial obstacle; 2 means substantial manual work with limited guidance; 3 means a documented route with unresolved setup work; 4 means the relevant path is demonstrated with minor limits; 5 means strong, direct evidence across that dimension. A null score means the supplied evidence is insufficient to assess it.

Setup ease receives 3 because the README documents a Compose route while our source-checkout test setup remained blocked by configuration. The inaccessible documentation prevents a full documentation assessment. Support channels and successor status alone do not establish community responsiveness or operational maturity, so those dimensions remain unassessed.

Alternatives

ProjectWhat it isPick it when
DocspellA personal document organizer with scanner and email ingestion, OCR, search and metadata suggestions.Evaluate it as a replacement archive when assisted metadata classification and email ingestion are priorities; the supplied evidence does not establish comparative performance.
Papermerge OSSA self-hosted system for scanned documents with OCR, search, tags and hierarchical folders.Evaluate it as a replacement when a folder hierarchy and desktop-like document browser suit your filing workflow. Assess the OSS edition separately from Papermerge Cloud.

Sources

  1. Paperless-ngx README
  2. Paperless-ngx features
  3. Paperless-ngx setup guide
  4. Paperless-ngx configuration
  5. Paperless-ngx v3.0.5
  6. Saved views upgrade issue

More self-hosted reviews

honk · aivpn · Free-GST-Billing-Software · AiSOC · billd-desk · ha-mcp · the whole board →