Paperless-ngx

TAS Score: S3/3 – D5/5 – A3 / T2 Critical criteria for this category: Exit, Recoverability.

Brief Description

Document management system that transforms your physical and digital documents into a searchable, organized archive. OCR, tagging, and full‑text search — all self‑hosted.

Architectural Role

Applications layer: central repository for documents, invoices, receipts, and correspondence. Acts as a digital filing cabinet.

Technical Autonomy

  • ✅ Works without internet (after initial setup; OCR and processing local)
  • ✅ Stores data locally (media files, database, index)
  • ✅ Does not require external accounts
  • ✅ Allows data export (files and database can be backed up)
  • ✅ Provides offline updates (manual upgrade via Docker)

Philosophical Assessment (whose.world criteria)

Criterion Status Comments
Pause Yes Services can be stopped; documents remain accessible via filesystem.
Exit Yes All documents stored as ordinary files; you can export the database and take your data elsewhere.
Recoverability Yes Database and media backups; built‑in export tools.
Visibility Yes Open source, fully documented, auditable.
External Dependencies Yes No mandatory external services; can run fully offline.

Configuration (Minimal)

Example docker-compose.yml snippet:

services:
  postgres:
    image: postgres:15
    environment:
      POSTGRES_DB: paperless
      POSTGRES_USER: paperless
      POSTGRES_PASSWORD: change-me
    volumes:
      - ./postgres-data:/var/lib/postgresql/data

  redis:
    image: redis:7

  paperless:
    image: ghcr.io/paperless-ngx/paperless-ngx:latest
    ports:
      - "8000:8000"
    volumes:
      - ./paperless-data:/usr/src/paperless/data
      - ./paperless-media:/usr/src/paperless/media
      - ./consume:/usr/src/paperless/consume
      - ./export:/usr/src/paperless/export
    environment:
      PAPERLESS_SECRET_KEY: change-me
      PAPERLESS_DBENGINE: postgresql
      PAPERLESS_DBHOST: postgres
      PAPERLESS_DBNAME: paperless
      PAPERLESS_DBUSER: paperless
      PAPERLESS_DBPASS: change-me
      PAPERLESS_REDIS: redis://redis:6379
    depends_on:
      - postgres
      - redis

Alternatives

  • Mayan EDMS – more complex, enterprise‑oriented.
  • Teedy – lighter but less feature‑rich.
  • Nextcloud – can store documents but lacks dedicated OCR and metadata extraction.

Trajectory

Direction: opening.

Paperless-ngx was created as a community fork of paperless-ng after the original maintainer abandoned the project. It is GPL-3.0, community-governed, and actively developed. No corporate ownership, no monetisation pressure, no enterprise tier.

Signal assessment:

Signal Status Evidence
License GPL-3.0; forked to preserve community development after upstream abandonment.
Feature gating No paid tier; all features available to all users.
Self-hosting Self-hosting is the only deployment model.
Governance Community-governed; active maintainer team; transparent roadmap.

Signal key: ✅ opening · ➖ neutral · ⚠️ closing


Sources


This site uses Just the Docs, a documentation theme for Jekyll.