selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

Paperless-ngx logo

Self-host Paperless-ngx

v3.4.2

Document management system for scanning and archiving

ReleaseOpen SourceGPL-3.0
Updatedlast week
LanguagePython
Setup difficultyModerate
ThemeDark mode
Stars
48 043
Rating
5.0 (1)
Port
8000 (webserver)
Docker
ghcr.io/paperless-ngx/paperless-ngx
Install with Docker Compose
Document list view in small cards layout (light mode)Document list view in small cards layout (dark mode)

What is Paperless-ngx?

Paperless-ngx is a community-supported document management system that turns scanned paper documents into a searchable digital archive. It provides OCR for text extraction, automatic document classification with correspondents and tags, full-text search, multi-user support with permissions, email fetching, webhooks, and AI-powered suggestions using local or remote LLMs. It runs via Docker Compose with optional PostgreSQL or MariaDB databases and a Redis-compatible message broker (Valkey by default). The project is the official successor to Paperless and Paperless-ng.

Paperless-ngx alternatives

Should you self-host Paperless-ngx?

Paperless-ngx scores 87/100 on selfhost.directory (how scoring works) and ranks #1 of 47 in Document Management. It has 48 043 GitHub stars, +1 636 in the last 30 days.

It shipped 29 stable releases in the past year. The latest, v3.4.2, came out on 3 November 2026. New versions land roughly every 4 days.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is GPL-3.0-licensed and written mostly in Python.

Its closest alternative on selfhost.directory is Stirling-PDF (87/100, 96 367 stars). Paperless-ngx scores higher overall. See Paperless-ngx vs Stirling-PDF side by side.

Features

  • AI-powered suggestions
  • Automatic document classification
  • Barcode Support
  • Email fetching
  • Multi-Language OCR
  • Multi-user support
  • OCR
  • PDF/A archive generation
  • Remote OCR
  • REST API
  • SSO/OIDC authentication
  • Webhooks

Paperless-ngx README

ci Crowdin Documentation Status codecov Chat on Matrix demo

Paperless-ngx

Paperless-ngx is a document management system that transforms your physical documents into a searchable online archive so you can keep, well, less paper.

Paperless-ngx is the official successor to the original Paperless & Paperless-ng projects and is designed to distribute the responsibility of advancing and supporting the project among a team of people. Consider joining us!

How to install Paperless-ngx

Install Paperless-ngx with Docker Compose

Docker and Docker Compose
Environment variables
PAPERLESS_SECRET_KEY, PAPERLESS_URL, PAPERLESS_TIME_ZONE, PAPERLESS_OCR_LANGUAGE, PAPERLESS_OCR_LANGUAGES, PAPERLESS_REDIS, PAPERLESS_DBENGINE, PAPERLESS_DBHOST, PAPERLESS_DBPORT, PAPERLESS_DBNAME, PAPERLESS_DBUSER, PAPERLESS_DBPASS

Official install script sets up docker-compose.yml, docker-compose.env, and .env files

How to configure Paperless-ngx

  • PAPERLESS_SECRET_KEYRequired. A unique secret key for session tokens and signing.

    values: Generate with: python3 -c "import secrets; print(secrets.token_urlsafe(64))"

  • PAPERLESS_REDISredis://localhost:6379Redis-compatible message broker URL

    values: redis://[username:password@]host:port[/db]

  • PAPERLESS_DBENGINEsqliteDatabase engine to use

    values: sqlite, postgresql, mariadb

  • USERMAP_UID1000UID of the paperless user in the container

    values: numeric UID

  • USERMAP_GID1000GID of the paperless group in the container

    values: numeric GID

Paperless-ngx releases & version history

@ Every self-hosted release, weekly

One Monday email with the week's stable releases across the directory.

FAQ

What databases are supported?

SQLite (default), PostgreSQL (recommended for multi-user), and MariaDB.

Can I migrate from Paperless-ng?

Yes, migrating from Paperless-ng is easy - just drop in the new docker image.

More in Document Management

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…