Paperless-ngx is a community-supported, GPL-3.0-licensed document management system written in Python that turns physical paperwork into a searchable, indexed online archive, and it is built for individuals, homelab operators and small teams who want to scan, index and archive their documents on infrastructure they control.

What it is

Paperless-ngx is a document management system, or DMS, that transforms physical documents into a searchable online archive so that its users can keep less paper. It is the official successor to the original Paperless and Paperless-ng projects, and it was created specifically to distribute the responsibility of advancing and supporting the project among a team of people rather than resting it on a single maintainer. The project lives in the Python ecosystem, with a Django back end and an Angular front end, and it carries topics covering archiving, document management, OCR, PDF handling, machine learning and LLM integration.

The concrete problem it solves is the accumulation of paper and scanned files that cannot be found again once they have been filed away. Paperless-ngx replaces its own predecessor projects, Paperless and Paperless-ng, and it is designed so that existing users of Paperless-ng can migrate by dropping in the new Docker image. Everything else follows from that replacement premise: documents enter the system, are indexed into a searchable archive, and stay there under the operator's own control.

Key capabilities

• Optical character recognition and PDF ingestion, reflected in the ocr, optical-character-recognition and pdf topics, so scanned paper becomes searchable text.
• Machine learning, AI and LLM tagging across the indexed archive, indicated by the ai, llm and machine-learning topics.
• A Django back end paired with an Angular front end, both named in the topic list.
• Deployment through docker compose, with the files in the /docker/compose directory configured to pull the image from the GitHub container registry.
• An install script that configures a docker compose environment in one command: bash -c "$(curl -L https://raw.githubusercontent.com/paperless-ngx/paperless-ngx/main/install-paperless-ngx.sh)".
• A hosted demo at demo.paperless-ngx.com using the login demo / demo for evaluation before any local setup.
• Localization into many languages, coordinated on Crowdin at crowdin.com/project/paperless-ngx.

Who uses it and how

• Self-hosters run the full stack through docker compose, pulling the image from the GitHub container registry rather than building from source.
• Existing Paperless-ng users migrate by dropping in the new Docker image, a path the documentation covers directly.
• Prospective users evaluate the interface through the hosted demo at demo.paperless-ngx.com, which is reset frequently and should not receive confidential information.
• Translators contribute localizations through the Crowdin project, and contributors coordinate in the Matrix room linked from the README.
• Contributors can join ongoing teams such as frontend and ci/cd, which the README names as areas needing sustained help.

Getting started

The easiest deployment is docker compose, using the compose files in the /docker/compose directory or the one-line install script that configures a compose environment. Step-by-step guides for alternative installation methods live in the documentation at docs.paperless-ngx.com.

How it compares

Among the tools named in the facts, Paperless-ngx sits directly downstream of Paperless and Paperless-ng: it is the official successor to both, and migration from Paperless-ng is treated as a simple image swap rather than a rebuild. Where the earlier projects concentrated maintenance on individual maintainers, Paperless-ngx is explicitly organized to distribute that responsibility across a team, and it remains GPL-3.0 licensed with no paid tier described in the material provided.

When to use it — and when not to

A self-hoster must be willing to operate a docker compose environment and its supporting services, since deployment is documented around that method rather than a managed offering. Anyone wanting a fully hosted, turnkey service should look elsewhere, because the project provides self-hosted deployment plus a resettable demo only. The README is deliberately sparse on features and screenshots, deferring both to the external documentation site, so anyone evaluating Paperless-ngx should expect to read docs.paperless-ngx.com rather than the repository front page.

bash -c "$(curl -L https://raw.githubusercontent.com/paperless-ngx/paperless-ngx/main/install-paperless-ngx.sh)"