Paperless-ngx is a community-supported open-source document management system that transforms your physical documents into a searchable online archive so you can keep, well, less paper.
Features:
Organize and index your scanned documents with tags, correspondents, types, and more.
Your data is stored locally on your server and is never transmitted or shared in any way.
Performs OCR on your documents, adding searchable and selectable text, even to documents scanned with only images.
Utilizes the open-source Tesseract engine to recognize more than 100 languages.
Documents are saved as PDF/A format which is designed for long term storage, alongside the unaltered originals.
Uses machine-learning to automatically add tags, correspondents and document types to your documents.
Supports PDF documents, images, plain text files, Office documents (Word, Excel, Powerpoint, and LibreOffice equivalents)1 and more.
Paperless stores your documents plain on disk. Filenames and folders are managed by paperless and their format can be configured freely with different configurations assigned to different documents.
Beautiful, modern web application that features:
Customizable dashboard with statistics.
Filtering by tags, correspondents, types, and more.
Bulk editing of tags, correspondents, types and more.
Drag-and-drop uploading of documents throughout the app.
Customizable views can be saved and displayed on the dash
Homepage
Download
Recent Releases
2.11.012 Jul 2024 12:05
major bugfix:
Breaking Changes:
Feature: Upgrade Gotenberg to v8 @stumpylog.
Features:
Enhancement: disable add split button when appropriate @shamoon.
Enhancement: wrapping of saved view fields d-n-d UI @shamoon.
Enhancement: support custom field icontains filter for select type @shamoon.
Feature: select custom field type @shamoon.
Feature: automatic sso redirect @shamoon.
Enhancement: show more columns in mail frontend admin @shamoon.
Enhancement: use request user as owner of split / merge docs @shamoon.
Enhancement: improve date parsing with accented characters @fdubuy.
Feature: improve history display of object names etc @shamoon.
Feature: Upgrade Gotenberg to v8 @stumpylog.
:
: include documents in trash for existing asn check @shamoon.
: include documents in trash in sanity check @shamoon.
: handle errors for trash actions and only show documents user can restore or delete @shamoon.
: dont include documents in trash in counts @shamoon.
: use temp dir for split / merge @shamoon.
Maintenance:
Chore: upgrade to DRF 3.15 @shamoon.
Chore(deps): Bump docker/build-push-action from 5 to 6 in the actions group @dependabot.
Chore: Ignores DRF 3.15.2 @stumpylog.
Chore: show docker tag in UI for ci test builds @shamoon.
Dependencies:
.
11 changes.
Chore: Bulk backend updates @stumpylog.
Chore(deps): Bump the frontend-angular-dependencies group in /src-ui with 14 updates @dependabot.
Chore(deps): Bump certifi from 2024.6.2 to 2024.7.4 @dependabot.
Chore(deps): Bump the frontend-angular-dependencies group in /src-ui with 6 updates @dependabot.
Chore(deps): Bump django-multiselectfield from 0.1.12 to 0.1.13 in the django group @dependabot.
Chore(deps): Bump docker/build-push-action from 5 to 6 in the actions group @dependabot.
Chore(deps): Bump the small-changes group across 1 directory with 4 updates @dependabot.
Chore(deps): Bump the frontend-angular-dependencies group in /src-ui with 16 updates @dependabot.
Chore(deps-dev): Bump ruff fro
2.10.227 Jun 2024 07:05
minor bugfix:
:
: always update document modified property on bulk edit operations @shamoon.
: correct frontend retrieval of trash delay setting @shamoon.
: index fresh document data after update archive file @shamoon.
: Safari browser PDF viewer not loading in 2.10.x @shamoon.
: Prefer the exporter metadata JSON file over the version JSON file @stumpylog.
All App Changes:
.
5 changes.
: always update document modified property on bulk edit operations @shamoon.
: correct frontend retrieval of trash delay setting @shamoon.
: index fresh document data after update archive file @shamoon.
: Safari browser PDF viewer not loading in 2.10.x @shamoon.
: Prefer the exporter metadata JSON file over the version JSON file @stumpylog.
.
2.10.019 Jun 2024 08:05
major bugfix:
Features:
Feature: documents trash aka soft delete @shamoon.
Enhancement: better boolean custom field display @shamoon.
Feature: Allow encrypting sensitive fields in export @stumpylog.
Enhancement: allow consumption of odg files @daniel-boehme.
:
: Document history could include extra fields @stumpylog.
: use local pdf worker js @shamoon.
: Revert masking the content field from auditlog @tribut.
: respect model permissions for tasks API endpoint @shamoon.
: Make the logging of an email message to be something useful @stumpylog.
Documentation:
Documentation: Corrections and clarifications for Python support @stumpylog.
Maintenance:
Chore(deps): Bump stumpylog/image-cleaner-action from 0.6.0 to 0.7.0 in the actions group @dependabot.
Chore: Configures dependabot to ignore djangorestframework @stumpylog.
Dependencies:
.
10 changes.
Chore(deps): Bump pipenv from 2023.12.1 to 2024.0.1 @stumpylog.
Chore(deps): Bump the small-changes group with 2 updates @dependabot.
Chore(deps-dev): Bump the development group with 2 updates @dependabot.
Chore(deps-dev): Bump ws from 8.15.1 to 8.17.1 in /src-ui @dependabot.
Chore(deps): Bump urllib3 from 2.2.1 to 2.2.2 @dependabot.
Chore: update packages used by mail parser html template @shamoon.
Chore(deps): Bump stumpylog/image-cleaner-action from 0.6.0 to 0.7.0 in the actions group @dependabot.
Chore(deps-dev): Bump the development group with 3 updates @dependabot.
Chore: Updates to latest Trixie version of Ghostscript 10.03.1 @stumpylog.
Chore(deps): Bump tornado from 6.4 to 6.4.1 @dependabot.
.
All App Changes:
.
17 changes.
Chore(deps): Bump the small-changes group with 2 updates @dependabot.
Chore(deps-dev): Bump the development group with 2 updates @dependabot.
Chore(deps-dev): Bump ws from 8.15.1 to 8.17.1 in /src-ui @dependabot.
Feature: documents trash aka soft delete @shamoon.
Enhancement: better boolean custom field display @shamoon.
: default order of documents gets los
2.9.004 Jun 2024 07:25
major feature:
Features:
Feature: Allow a data only export/import cycle @stumpylog.
Change: rename 'redo OCR' to 'reprocess' to clarify behavior @shamoon.
Enhancement: Support custom path for the classification file @lino-b.
Enhancement: default to title/content search, allow choosing full search link from global search @shamoon.
Enhancement: only include correspondent 'last_correspondence' if requested @shamoon.
Enhancement: delete pages PDF action @shamoon.
Enhancement: support custom logo / title on login page @shamoon.
:
: including ordering param for id _ _in retrievals @shamoon.
: Don't allow the workflow save to override other process updates @stumpylog.
: consistently use created_date for doc display @shamoon.
Maintenance:
Chore: Change the code formatter to Ruff @stumpylog.
Chore: Backend updates @stumpylog.
Chore(deps): Bump crowdin/github-action from 1 to 2 in the actions group @dependabot.
Dependencies:
.
12 changes.
Chore(deps-dev): Bump jest-preset-angular from 14.0.4 to 14.1.0 in /src-ui in the frontend-jest-dependencies group @dependabot.
Chore: Backend dependencies update @stumpylog.
Chore(deps): Bump crowdin/github-action from 1 to 2 in the actions group @dependabot.
Chore: Updates Ghostscript to 10.03.1 @stumpylog.
Chore(deps-dev): Bump the development group across 1 directory with 2 updates @dependabot.
Chore(deps): Bump the small-changes group with 3 updates @dependabot.
Chore(deps): Use psycopg as recommended @stumpylog.
Chore(deps-dev): Bump the development group with 2 updates @dependabot.
Chore(deps): Bump requests from 2.31.0 to 2.32.0 @dependabot.
Chore(deps): Bump the frontend-angular-dependencies group in /src-ui with 19 updates @dependabot.
Chore: Backend updates @stumpylog.
Chore: revert pngx pdf viewer to third party package @shamoon.
.
All App Changes:
.
19 changes.
Chore(deps-dev): Bump jest-preset-angular from 14.0.4 to 14.1.0 in /src-ui in the frontend-jest-dependencies group @dependabot.
: incl
2.8.616 May 2024 09:45
minor bugfix:
:
Security: disallow API remote-user auth if disabled @shamoon.
: retain sort field from global search filtering, use FILTER_HAS_TAGS_ALL @shamoon.
All App Changes:
.
2 changes.
Security: disallow API remote-user auth if disabled @shamoon.
: retain sort field from global search filtering, use FILTER_HAS_TAGS_ALL @shamoon.
.
2.8.312 May 2024 08:25
minor bugfix:
:
: respect superuser for document history @shamoon.
: allow 0 in monetary field @shamoon.
: custom field removal doesnt always trigger change detection @shamoon.
: Downgrade and lock lxml @stumpylog.
: correctly handle global search esc key when open and button foucsed @shamoon.
: consistent monetary field display in list and cards @shamoon.
: doc links and more illegible in light mode @shamoon.
: Allow auditlog to be disabled @stumpylog.
Documentation:
Chore(docs): Update the sample Compose file to latest database @stumpylog.
All App Changes:
.
7 changes.
: respect superuser for document history @shamoon.
: allow 0 in monetary field @shamoon.
: custom field removal doesnt always trigger change detection @shamoon.
: correctly handle global search esc key when open and button foucsed @shamoon.
: consistent monetary field display in list and cards @shamoon.
: doc links and more illegible in light mode @shamoon.
: Allow auditlog to be disabled @stumpylog.
.
2.8.208 May 2024 04:25
minor bugfix:
:
: Restore the compression of static files for x86_64 @stumpylog.
: make backend monetary validation accept unpadded decimals @shamoon.
: allow bulk edit with existing fields @shamoon.
: table view doesn't immediately display custom fields on app startup @shamoon.
: dont use limit in subqueries in global search for mariadb compatibility @shamoon.
: exclude admin perms from group permissions serializer @shamoon.
: global search text illegible in light mode @shamoon.
: document history text color illegible in light mode @shamoon.
All App Changes:
.
10 changes.
: Restore the compression of static files for x86_64 @stumpylog.
: make backend monetary validation accept unpadded decimals @shamoon.
: allow bulk edit with existing fields @shamoon.
Enhancement: show custom field name on cards if empty, add tooltip @shamoon.
Security: Disable in pdfjs @shamoon.
: table view doesn't immediately display custom fields on app startup @shamoon.
: dont use limit in subqueries in global search for mariadb compatibility @shamoon.
: exclude admin perms from group permissions serializer @shamoon.
: global search text illegible in light mode @shamoon.
: document history text color illegible in light mode @shamoon.
.
2.7.211 Apr 2024 10:45
minor bugfix:
:
: select dropdown background colors not visible in light mode @shamoon.
: spacing in reset and incorrect display in saved views @shamoon.
: disable invalid create endpoints @shamoon.
: dont initialize page numbers, allow split with browser pdf viewer @shamoon.
All App Changes:
.
4 changes.
: select dropdown background colors not visible in light mode @shamoon.
: spacing in reset and incorrect display in saved views @shamoon.
: disable invalid create endpoints @shamoon.
: dont initialize page numbers, allow split with browser pdf viewer @shamoon.
.
2.7.108 Apr 2024 00:05
minor bugfix:
:
: Only disable split button if pages = 1 @shamoon.
: Use correct custom field id when splitting @shamoon.
: Rotation fails due to celery chord @stumpylog.
: split user / group objects error @shamoon.
All App Changes:
.
4 changes.
: Only disable split button if pages = 1 @shamoon.
: Use correct custom field id when splitting @shamoon.
: Rotation fails due to celery chord @stumpylog.
: split user / group objects error @shamoon.
.
2.6.319 Mar 2024 06:05
minor feature:
:
: allow setting allauth @shamoon.
Change: dont require empty bulk edit parameters @shamoon.
Dependencies:
.
4 changes.
Chore(deps-dev): Bump follow-redirects from 1.15.5 to 1.15.6 in /src-ui @dependabot.
Chore(deps-dev): Bump the development group with 3 updates @dependabot.
Chore(deps): Bump the django group with 1 update @dependabot.
Chore(deps): Bump the small-changes group with 2 updates @dependabot.
.
All App Changes:
.
8 changes.
Chore(deps-dev): Bump follow-redirects from 1.15.5 to 1.15.6 in /src-ui @dependabot.
: allow setting allauth @shamoon.
Change: remove credentials from redis url in system status @shamoon.
Chore(deps-dev): Bump the development group with 3 updates @dependabot.
Chore(deps): Bump the django group with 1 update @dependabot.
Chore(deps): Bump the small-changes group with 2 updates @dependabot.
Change: dont require empty bulk edit parameters @shamoon.
: missing translation string @DimitriDR.
.
2.6.210 Mar 2024 12:05
minor bugfix:
Features:
Enhancement: move and rename files when storage paths deleted, update file handling docs @shamoon.
Enhancement: better detection of default currency code @shamoon.
:
: make document counts in object lists permissions-aware @shamoon.
All App Changes:
.
3 changes.
Enhancement: move and rename files when storage paths deleted, update file handling docs @shamoon.
: make document counts in object lists permissions-aware @shamoon.
Enhancement: better detection of default currency code @shamoon.
.
2.5.427 Feb 2024 03:16
minor bugfix:
:
: handle title placeholder for docs without original_filename @shamoon.
: bulk edit objects does not respect global permissions @shamoon.
: intermittent save warnings @shamoon.
: inotify read timeout not in ms @grembo.
: allow relative date queries not in quick list @shamoon.
: pass rule id to consumed.eml files @shamoon.
Dependencies:
Chore(deps): Bump cryptography from 42.0.2 to 42.0.4 @dependabot.
Chore(deps-dev): Bump ip from 2.0.0 to 2.0.1 in /src-ui @dependabot.
Chore(deps): Bump undici and @angular-devkit/build-angular in /src-ui @dependabot.
All App Changes:
.
8 changes.
: handle title placeholder for docs without original_filename @shamoon.
: bulk edit objects does not respect global permissions @shamoon.
: intermittent save warnings @shamoon.
: inotify read timeout not in ms @grembo.
Chore(deps-dev): Bump ip from 2.0.0 to 2.0.1 in /src-ui @dependabot.
Chore(deps): Bump undici and @angular-devkit/build-angular in /src-ui @dependabot.
: allow relative date queries not in quick list @shamoon.
: pass rule id to consumed.eml files @shamoon.
.
2.5.316 Feb 2024 10:45
minor bugfix:
:
: dont allow allauth redirects to any host @shamoon.
: Interaction when both splitting and ASN are enabled @stumpylog.
: moved ssl_mode parameter for mysql backend engine @MaciejSzczurek.
All App Changes:
.
3 changes.
: dont allow allauth redirects to any host @shamoon.
: Interaction when both splitting and ASN are enabled @stumpylog.
: moved ssl_mode parameter for mysql backend engine @MaciejSzczurek.
.
2.5.012 Feb 2024 04:05
major feature:
Breaking Changes:
Enhancement: bulk delete objects @shamoon.
Notable Changes:
Feature: OIDC social authentication @mpflanzer.
Features:
Enhancement: confirm buttons @shamoon.
Enhancement: bulk delete objects @shamoon.
Feature: allow create objects from bulk edit @shamoon.
Feature: Allow tagging by putting barcodes on documents @pkrahmer.
Feature: Cache metadata and suggestions in Redis @stumpylog.
Feature: Japanese translation @shamoon.
Feature: option for auto-remove inbox tags on save @shamoon.
Enhancement: allow paperless to run in read-only filesystem @hegerdes.
Enhancement: mergeable bulk edit permissions @shamoon.
Enhancement: re-implement remote user auth for unsafe API requests as opt-in @shamoon.
Enhancement: Respect PDF cropbox for thumbnail generation @henningBunk.
:
: Test metadata items for Unicode @stumpylog.
Change: try to show preview even if metadata fails @shamoon.
: only check workflow trigger source if not empty @shamoon.
: frontend validation of number fields fails upon save @shamoon.
: Explicit validation of custom field name unique constraint @shamoon.
: Don't attempt to retrieve object types user doesn't have permissions to @shamoon.
Documentation:
Documentation: add detail about consumer polling behavior @silmaril42.
Paperless-ngx Demo: new and improved @shamoon.
Documentation: Add docs about missing timezones in MySQL/MariaDB @Programie.
Maintenance:
Chore(deps): Bump the actions group with 1 update @dependabot.
Chore(deps): Bump the actions group with 1 update @dependabot.
Dependencies:
.
9 changes.
Chore: Backend dependencies update @stumpylog.
Chore(deps-dev): Bump @playwright/test from 1.40.1 to 1.41.2 in /src-ui @dependabot.
Chore(deps): Bump the frontend-angular-dependencies group in /src-ui with 19 updates @dependabot.
Chore(deps-dev): Bump the frontend-jest-dependencies group in /src-ui with 2 updates @dependabot.
Chore(deps-dev): Bump the frontend-eslint-dependencies group
2.4.329 Jan 2024 03:15
minor bugfix:
:
: Ensure the scratch directory exists before consuming via the folder @stumpylog.
All App Changes:
: Ensure the scratch directory exists before consuming via the folder @stumpylog.
2.4.125 Jan 2024 09:25
minor bugfix:
Breaking Changes:
Change: merge workflow permissions assignments instead of overwrite @shamoon.
:
: Minor frontend things in 2.4.0 @shamoon.
: install script fails on alpine linux @shamoon.
: enforce permissions for app config @shamoon.
: render images not converted to pdf, refactor doc detail rendering @shamoon.
: Dont parse numbers with exponent as integer @shamoon.
Maintenance:
Chore: Build - branches @shamoon.
Dependencies:
Chore(deps-dev): Bump the development group with 1 update @dependabot.
All App Changes:
.
7 changes.
Revert "Enhancement: support remote user auth directly against API (DRF)" @shamoon.
: Minor frontend things in 2.4.0 @shamoon.
: enforce permissions for app config @shamoon.
Change: merge workflow permissions assignments instead of overwrite @shamoon.
Chore(deps-dev): Bump the development group with 1 update @dependabot.
: render images not converted to pdf, refactor doc detail rendering @shamoon.
: Dont parse numbers with exponent as integer @shamoon.
.
2.4.020 Jan 2024 03:15
major bugfix:
Features:
Enhancement: support remote user auth directly against API (DRF) @shamoon.
Feature: Add additional caching support to suggestions and metadata @stumpylog.
Feature: help tooltips @shamoon.
Enhancement: warn when outdated doc detected @shamoon.
Feature: app branding @shamoon.
:
: doc link removal when has never been assigned @shamoon.
: dont lose permissions ui if owner changed from @shamoon.
: Getting next ASN when no documents have an ASN @stumpylog.
: signin username floating label @shamoon.
: shared by me filter with multiple users / groups in postgres @shamoon.
: Catch new warning when loading the classifier @stumpylog.
: doc detail component @shamoon.
Maintenance:
Chore: better bootstrap icons @shamoon.
Chore: outdated support / general discussions @shamoon.
Dependencies:
Chore(deps): Bump the small-changes group with 2 updates @dependabot.
Chore(deps-dev): Bump the development group with 2 updates @dependabot.
Chore(deps-dev): Bump jinja2 from 3.1.2 to 3.1.3 @dependabot.
All App Changes:
.
16 changes.
: doc link removal when has never been assigned @shamoon.
Chore: better bootstrap icons @shamoon.
: dont lose permissions ui if owner changed from @shamoon.
Enhancement: support remote user auth directly against API (DRF) @shamoon.
: Getting next ASN when no documents have an ASN @stumpylog.
Feature: Add additional caching support to suggestions and metadata @stumpylog.
Chore(deps): Bump the small-changes group with 2 updates @dependabot.
Chore(deps-dev): Bump the development group with 2 updates @dependabot.
: signin username floating label @shamoon.
Feature: help tooltips @shamoon.
Enhancement / QoL: show selected tasks count @shamoon.
: shared by me filter with multiple users / groups in postgres @shamoon.
: doc detail component @shamoon.
Enhancement: warn when outdated doc detected @shamoon.
Feature: app branding @shamoon.
Chore: Initial refactor of consume task @stumpylog.
.
2.3.312 Jan 2024 03:15
minor bugfix:
Enhancements:
Enhancement: Explain behavior of unset app config boolean to user @shamoon.
Enhancement: title assignment placeholder error handling, fallback @shamoon.
:
: Don't require the JSON user arguments field, interpret empty string as @stumpylog.
Maintenance:
Chore: Backend dependencies update @stumpylog.
Chore: add pre-commit hook for codespell @shamoon.
All App Changes:
.
5 changes.
Enhancement: Explain behavior of unset app config boolean to user @shamoon.
Enhancement: title assignment placeholder error handling, fallback @shamoon.
Chore: Backend dependencies update @stumpylog.
: Don't require the JSON user arguments field, interpret empty string as @stumpylog.
Chore: add pre-commit hook for codespell @shamoon.
.