Paperless-ngx review: open-source document management that replaces filing cabinets

What Paperless-ngx does and where it came from

Paperless-ngx is a community supported open source document management system designed to transform physical documents into a searchable digital archive. The software performs optical character recognition on scanned files, extracts metadata, and organizes everything through tags, correspondents, document types, and storage paths. Data is stored locally on your own server and is never transmitted externally.

The project is the official successor to the original Paperless and Paperless-ng efforts. In 2017 Daniel Quinn released the first version motivated by a desire to stop searching through dusty folders for documents. After the original maintainer stepped away, the community forked the project; Paperless-ngx emerged in 2022 and has since become the actively maintained continuation, designed to distribute responsibility among a team rather than relying on a single developer.

Under the hood, Paperless-ngx is a Django web application that uses Tesseract for OCR with support for over one hundred languages. Documents are saved in the PDF/A archival format alongside unaltered originals. Machine learning algorithms automatically suggest tags, correspondents, and document types based on how you have classified existing documents. The system supports PDF, images, plain text, and optionally Office formats when the Tika integration is enabled.

Installation demands and hardware reality

The recommended deployment method is Docker Compose. An install script automates the process by asking configuration questions about URL, port, time zone, storage folders, OCR languages, database choice, and admin credentials, then downloads compose files, pulls container images, and starts the stack. Manual setup involves downloading the compose YAML for your chosen database backend, editing environment variables, and running the containers. The official documentation states that Docker and Docker Compose must be installed, and macOS users need GNU sed and wget.

Bare metal installation is supported but significantly more complex, requiring manual installation of Python dependencies, Redis or Valkey, PostgreSQL or MariaDB, Tesseract with language packs, ImageMagick, Ghostscript, and numerous other system libraries. The documentation confirms Paperless runs on Linux only; Windows is not supported for bare metal installs.

Hardware requirements are workload dependent. Community reports indicate a Raspberry Pi 3B will run the system but OCR becomes painfully slow; the FAQ recommends 4 GB RAM as a practical minimum. Users report comfortable performance on repurposed thin clients with dual core processors and 4 GB RAM for typical household document volumes. For heavier workloads or faster processing, a quad core system with SSD storage is recommended. The software runs on ARM and x86 architectures.

Daily use and the interface

The web UI is a single page application built with modern web technologies designed to be fast and responsive. The dashboard displays saved views, and documents can be uploaded via button or drag and drop anywhere in the application. The interface provides three different list styles for browsing, extensive filtering by tags, correspondents, types, and dates, bulk edit operations, and side by side document editing.

Documents are consumed either by dropping files into a monitored folder, uploading through the web UI, or configuring email accounts to automatically ingest attachments. The consumption process runs OCR, applies matching rules, and files the document. The system watches the consumption directory using inotify on supported filesystems; network shares without inotify support require enabling polling mode instead. A built in tour feature highlights key interface elements for new users.

Mobile access works through the responsive web UI, but the experience is not optimized for phone based document capture. The community maintains third party mobile applications for iOS and Android that provide better scanning workflows. Search is powered by full text indexing with autocomplete, relevance ranking, and result highlighting. Saved views allow customization of frequently used filters and can be pinned to the dashboard.

Exit strategy and data portability

Paperless-ngx stores documents in a straightforward filesystem structure managed by Docker volumes or user specified bind mounts. Original files are preserved with checksums verified by a scheduled sanity checker to detect any corruption. The system never modifies your original documents. Filenames default to internal document IDs but can be customized through configurable filename format templates.

A built in document exporter creates a portable archive containing original files alongside JSON metadata for tags, correspondents, dates, and custom fields. This export can be used for migration to other systems or as part of a backup strategy. The REST API provides full programmatic access to all document metadata and file content, enabling custom export scripts or integrations with other tools.

Because everything runs in Docker containers or on your own Linux system, there is no vendor lock in. Data lives in standard PostgreSQL, MariaDB, or SQLite databases that can be backed up independently. Moving to a different server or infrastructure is a matter of copying volumes and restarting containers. The GPL license ensures the source code remains open regardless of future project direction.

Community health and update track record

The GitHub repository has accumulated over 42,000 stars with more than 370 contributors. Commit activity is steady with frequent pull requests merged by a team of maintainers. Releases follow a regular cadence; version 2.20.15 shipped in late April 2026 addressing a security issue, and a version 3.0 beta release candidate appeared in May. The project actively addresses reported bugs and security issues with prompt patch releases.

Community support is available through GitHub Discussions where users share configuration help, troubleshooting steps, and feature requests. A Matrix chat room provides real time assistance. The documentation is comprehensive and includes setup guides for Docker, bare metal, NAS platforms like Synology and Unraid, and migration from older Paperless versions. Translation efforts coordinate through Crowdin with the interface available in many languages.

The project maintains a transparent security posture. The README explicitly states that Paperless should never be run on untrusted hosts because document storage is unencrypted, and recommends local server deployment with backups. Security issues are tracked publicly, and the maintainer team responds to community reported vulnerabilities with fixes and coordinated disclosure.