SAFEOPENSOURCE SECURITY COMPLIANCE AUDIT
Automated OpenSSF, CVE, License & Governance Verification Report

Paperless-ngx
HealthyCommunity-driven document management system that indexes, OCRs, and organizes scanned documents.
Why 91? In plain words.
What we found when we checked it. Last checked 6 Nov.
- Actively looked afterNew code 0 days before our check on 6 Nov
- Free and open licenceGNU General Public License v3.0
Get it running.
The project's own guide walks you through it. Our AI assistant can help if you get stuck.
What is Paperless-ngx used for?
Live deployment interface view · Powered by official repository source
Community-driven document management system that indexes, OCRs, and organizes scanned documents.
Encrypted File Synchronization
Cross-platform folders syncing automatically across laptop, phone, and server.
Personal S3 & Document Vault
High-speed object storage, media archiving, and optical character document recognition.
Local-First Data Ownership
Eliminate recurring monthly storage fees and retain unmonitored privacy.
AI Repo Scan & Security Analysis
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.
Security 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.
For 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.
Technical Specifications & Usage Profiles
SEC-01What It's Used ForPRIMARY WORKLOADS
Primary real-world deployment workloads verified for this application architecture:
Primary cloud storage Workloads
Community-driven document management system that indexes, OCRs, and organizes scanned documents.
Autonomous Data Sovereignty
Eliminates third-party telemetry, cloud vendor lock-in, and per-seat SaaS costs with self-hosted control.
Open Architecture & Interoperability
Built on Python with standard GPL-3.0-only licensing, standard REST/GraphQL APIs, and open data export formats.
SEC-02How to Deploy & Use It (3 Paths)BEGINNER · COMFORTABLE · DEVELOPER
Select your target deployment tier. Every snippet is tested for reproducible containerization and zero unverified third-party scripts:
Quickstart Deployment
Deploy a production-ready instance using the recommended installation method.
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:latestDocker Compose & Persistent Volumes
Mount configuration volumes, configure internal environment variables, and route via reverse proxy with TLS.
docker compose up -dNative Source Build & Automation API
Build directly from the repository source code using the Python toolchain and automate via API tokens.
git clone https://github.com/paperless-ngx/paperless-ngx.git && cd $(basename "paperless-ngx/paperless-ngx")SEC-03Hardware & Runtime Requirements2 GB RAM MIN
SEC-04Target Audience & Honest LimitationsPERFECT FOR vs SKIP IT IF
Perfect For
- •Self-hosters and developers looking for a reliable open-source cloud storage solution.
- •Teams requiring full custody of data under GPL-3.0-only terms with zero external telemetry.
- •Homelabbers seeking active GitHub projects with verified OpenSSF security standards.
Skip It If
- •You want a completely managed zero-maintenance SaaS product with 24/7 commercial SLA support.
- •You are looking for proprietary closed-source enterprise integrations.
Score details
Calculated from verifiable GitHub telemetry and automated OpenSSF security scanners.
Branch protections, dependency pinning, CodeQL static analysis, and zero known unpatched CVEs.
Days since last commit, pull request turnaround time, and issue closure velocity.
Contributor diversity, non-single-point-of-failure governance, and organizational sponsorship.
Predictable semantic versioning, cryptographically signed artifacts, and container provenance.
Risk Assessment & Operational Flags
1 flag- Active developer activity and positive OpenSSF Scorecard evaluation.
Can I use this commercially?
Strong copyleft. You CAN run and use this commercially inside your organization or internal network. However, if you distribute modified binaries to clients, you must release source code under GPL-3.0.
- ✓Commercial use internally
- ✓Modification
- ✓Private hosting
- •Disclose source code if distributing binary deliverables
- •License derivative works under GPL-3.0
- •State changes made
Watch Paperless-ngx for Vulnerability Alerts
Receive real-time alerts if Paperless-ngx drops below 80 Safety Score or discloses a critical CVE.
Deployment & Installation
Commands to get the code. For a full setup, follow the project's own guide.
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:latestHetzner Cloud & DigitalOcean
Spin up dedicated Linux nodes with Docker in under 60 seconds. Ideal for running containers with custom domains and reverse proxies.
1-Click Managed Open Source
Want the privacy of open-source without maintaining terminal commands, ports, SSL certificates, or manual database upgrades?
Paperless-ngx Deployment Architecture
Visual component flow from public clients down through the edge reverse proxy, containerized runtime, and persistent volume storage.
›View Raw GitHub Mermaid.js Source Code↓
```mermaid
graph TD
subgraph Clients ["1. Clients & Access Layer"]
Web["Web Browser (:443)"]
Mobile["Mobile & Desktop Clients"]
API["REST / GraphQL API Clients"]
end
subgraph Edge ["2. Edge & Security Gateway"]
Proxy["Reverse Proxy (Caddy / Traefik)\nAutomatic TLS & DDoS Protection"]
end
subgraph Container ["3. Paperless-ngx Core Service"]
App["Paperless-ngx Daemon Container\nRuntime: Python\nLicense: GPL-3.0-only"]
end
subgraph Storage ["4. Persistent State & Volumes"]
Data[("Paperless-ngx Data Storage\n(/data /media)")]
DB[("PostgreSQL 16\nPersistent Database")]
end
Web -->|HTTPS| Proxy
Mobile -->|HTTPS / WSS| Proxy
API -->|Authenticated Calls| Proxy
Proxy -->|Local Network| App
App -->|Mounts| Data
App -->|Queries| DB
```Control Paperless-ngx with AI Coding Agents
Equip Claude Code, Cursor, Hermes Agent, and Codex to autonomously audit and orchestrate Paperless-ngx.
Using SafeOpenSource telemetry, deploy and audit Paperless-ngx (Safety Score: 91/100, License: GPL-3.0-only). Verify OpenSSF scorecard 7.9, isolate Docker network, and enforce non-root UID 1000:1000.
Install the SafeOpenSource skill to let your agent verify repository scores before installing:
npx skills add safeopensource
Alternatives in Cloud Storage & Sync
serviette
cloud-storageserviette
pathwaycom/servietteReady-to-run cloud templates for RAG, AI pipelines, and enterprise search with live data. 🐳Docker-friendly.⚡Always in sync with Sharepoint, Google Drive, S3, Kafka, PostgreSQL, real-time data APIs, and more.
floci
cloud-storagefloci
floci-io/flociLight, fluffy, and always free - The AWS Local Emulator alternative
Syncthing
cloud-storageSyncthing
syncthing/syncthingContinuous peer-to-peer decentralized file synchronization protocol and engine with end-to-end encryption.
Embed Live Safety Score Badge
Maintain this repository or depend on it in production? Embed a live 0–100 Safety Score badge in your README. Badges are cached for 24 hours and updated automatically.
[](https://safeopensource.org/tools/paperless-ngx)