{
  "slug": "paperless-ngx",
  "repo": "paperless-ngx/paperless-ngx",
  "name": "Paperless-ngx",
  "tagline": "Community-driven document management system that indexes, OCRs, and organizes scanned documents.",
  "category": "cloud-storage",
  "license_spdx": "GPL-3.0-only",
  "stars": 47754,
  "contributors": 260,
  "last_push_days": 0,
  "latest_release": "v2.14.0",
  "safety_score": 91,
  "verdict": "healthy",
  "risk_reasons": [
    "Active developer activity and positive OpenSSF Scorecard evaluation."
  ],
  "scorecard": 7.9,
  "components": {
    "security_health": 88,
    "maintenance": 96,
    "community": 91,
    "releases": 88
  },
  "language": "Python",
  "self_host_difficulty": "Medium",
  "install_commands": {
    "docker": "docker run -d --name paperless-ngx -p 8000:8000 -v /opt/paperless/data:/usr/src/paperless/data -v /opt/paperless/media:/usr/src/paperless/media -v /opt/paperless/consume:/usr/src/paperless/consume -v /opt/paperless/export:/usr/src/paperless/export -e PAPERLESS_REDIS=redis://redis:6379 -e PAPERLESS_SECRET_KEY=change-me ghcr.io/paperless-ngx/paperless-ngx:latest"
  },
  "ai_report": "Paperless-ngx is the preeminent open-source document management system (DMS), built upon a modern Django web framework, Celery asynchronous task queue, and Tesseract OCR optical character recognition engine. Forked from the original Paperless and Paperless-ng projects to preserve community momentum, it automatically ingests PDFs, images, and office documents from email inboxes or local scanner watch folders. The underlying ingestion pipeline extracts text, generates searchable PDF/A archives, indexes full-text content in Whoosh or SQLite FTS5, and applies machine-learning classifiers via Scikit-learn to automate document tagging, correspondent attribution, and document type classification.\n\nSecurity auditing shows consistent maintainer diligence across Python dependencies, with active integration of Dependabot, Bandit static security scanning, and automated continuous integration testing across every pull request. The application enforces role-based access control (RBAC), multi-user object permissions, and native multi-factor authentication (TOTP) through modern Django authentication backends. Historical CVEs have been minimal and largely isolated to third-party parsing vulnerabilities in underlying image processing libraries such as Ghostscript and Pillow, which the maintainer team promptly addresses via pinned, sanitized base container updates. Paperless-ngx earns an OpenSSF Scorecard rating of 7.9 with high marks for branch protections and active maintainer responsiveness.\n\nFor dependable self-hosting, administrators should deploy Paperless-ngx alongside dedicated Redis and PostgreSQL backend containers rather than relying on SQLite under high concurrent write loads. Ensure the consumption folder (/consume) is strictly protected against unauthorized file dropping, configure PAPERLESS_WORKER_CONCURRENCY to match available CPU cores to avoid machine exhaustion during batch scans, and establish automated cron exports via document_exporter to ensure tamper-resistant offsite document backups. With outstanding community velocity and an indispensable utility profile, Paperless-ngx is awarded a Healthy verdict and a 91/100 Safety Score.",
  "scanned_at": "2026-11-06T08:58:16.395Z",
  "website_url": "https://docs.paperless-ngx.com",
  "ai_report_status": "approved",
  "created_at": "2026-10-01T12:00:00.000Z",
  "updated_at": "2026-10-01T12:00:00.000Z",
  "setup_steps": {
    "status": "none",
    "steps": [],
    "source_url": "https://github.com/paperless-ngx/paperless-ngx#readme",
    "model": "ag/gemini-3.8-flash-high",
    "written_at": "2026-11-05T17:49:55.154Z",
    "reason": "no self-host instructions in the README"
  },
  "archived": false,
  "unlisted": false
}