Paperless-ngx

TAS Score: S3/3 – D5/5 – A3 / T2

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

Related Recipes

• Minimal Autonomous Server – can be extended with Paperless for document archiving.

Alternatives

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

Sources

• Website

• Documentation

• Repository

• Docker image

• Community

Trajectory

Stable — community fork.

Paperless-ngx is a community fork of paperless-ng (itself a fork of the original paperless). The project has no commercial entity behind it. It is maintained by a volunteer team and has grown steadily. No enterprise tier, no cloud dependency. Direction: stable opening.