paperless-ngx /paperless-ngx
A community-supported supercharged document management system: scan, index and archive all your documents
★ 48,140⑂ 3,386👁 165⑃ 5,026● 2,855▤ 170
+22
Daily
+212
Weekly
48,140
stars
3,386
forks
165
watchers
5,026
prs
2,855
issues
170
releases
README
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!
Thanks to the generous folks at Fyra Stack, a demo is available at demo.paperless-ngx.com using login demo / demo. _Note: demo content is reset frequently and confidential information should not be uploaded._
- Features
- Getting started
- Contributing
- Community Support
- Translation
- Feature Requests
- Bugs
- Related Projects
- Important Note
Demo hosting provided by:
Fyra Stack
Features
A full list of features and screenshots are available in the documentation.
Getting started
The easiest way to deploy paperless is docker compose. The files in the /docker/compose directory are configured to pull the image from the GitHub container registry.
If you'd like to jump right in, you can configure a docker compose environment with our install script:
bash
bash -c "$(curl -L https://raw.githubusercontent.com/paperless-ngx/paperless-ngx/main/install-paperless-ngx.sh)"
More details and step-by-step guides for alternative installation methods can be found in the documentation.
Migrating from Paperless-ng is easy, just drop in the new docker image! See the documentation on migrating for more details.
Documentation
The documentation for Paperless-ngx is available at https://docs.paperless-ngx.com.
Contributing
If you feel like contributing to the project, please do! Bug fixes, enhancements, visual fixes etc. are always welcome. If you want to implement something big: Please start a discussion about that! The documentation has some basic information on how to get started.
Community Support
People interested in continuing the work on paperless-ngx are encouraged to reach out here on github and in the Matrix Room. If you would like to contribute to the project on an ongoing basis there are multiple teams (frontend, ci/cd, etc) that could use your help so please reach out!
Translation
Paperless-ngx is available in many languages that are coordinated on Crowdin. If you want to help out by translating paperless-ngx into your language, please head over to https://crowdin.com/project/paperless-ngx, and thank you! More details can be found in CONTRIBUTING.md.
Feature Requests
Feature requests can be submitted via GitHub Discussions, you can search for existing ideas, add your own and vote for the ones you care about.
Bugs
For bugs please open an issue or start a discussion if you have questions.
Related Projects
Please see the wiki for a user-maintained list of related projects and software that is compatible with Paperless-ngx.
Important Note
Document scanners are typically used to scan sensitive documeTop issues
#14782[BUG] Owner selection unavailable when saving a new view0 comments · 2026-11-15#14779[BUG] Scheduled workflow with *.pdf filename filter fails with invalid embedded option on PostgreSQL0 comments · 2026-11-15
Discussions
#14781[Feature Request] Honor view_global_statistics for document_count on tags, correspondents, document types and storage paths0 comments · 2026-11-15#14777[Feature Request] Treat PDFs whose text is only an invisible OCR layer as scans0 comments · 2026-11-15#14776[Feature Request] Metadata-only view permission (see metadata, but not full text or files)0 comments · 2026-11-15#14775Allow force remote OCR on individual documents, overriding the global "auto" setting0 comments · 2026-11-15#14774[Feature Request] Refresh llama-index-llms-openai-like lock to pick up gpt-6 model support1 comments · 2026-11-14#14772[Feature Request] Web UI configuration screen for environment variables to avoid manual .env editing and restarts1 comments · 2026-11-14#14770[Feature Request] Keep AI suggestions from the "Apply AI suggestions" workflow action for the document view0 comments · 2026-11-14#14767[Feature Request] Settings for the LLM index queue and embedding retries/timeout1 comments · 2026-11-14
Latest release
Paperless-ngx v3.4.2 v3.4.2 2026-11-03paperless-ngx 3.4.2 Bug Fixes - Fix: mobile save button display obsessing @shamoon (14676) - Fix: make index and llmindex init wait for tesseract language install @stumpylog (14670) - Fix: prevent loss of save view name on save + close @shamoon (14667) - Fixhancement: doc detail mobile ux tweaks @shamoon (14664) - Fix: Bumps filelock to 4.2.6 to pick up ACL related fixes @stumpylog (14656) - Fix: ensure import bulk\_edit tasks in Celery workers @shamoon (14653) - Fixhancement: add tag names to document history list @shamoon (14625) - Fix: add button type to zoom buttons to preven