Paperless-ngx Release Notes

paperless-ngx 3.3.0

Features / Enhancements

• Enhancement: more control over suggestion requests @shamoon (#14258)
• Chorehancement: set manifest CORS for credentials @shamoon (#14307)
• Enhancement: include Django admin with 2FA @shamoon (#14270)
• Feature: propagate resolved secrets to interactive container shells @stumpylog (#14254)
• Enhancement: support separate embedding API key @furkanural (#14067)
• Enhancement: support passthrough extra params for LLMs @shamoon (#14202)
• Feature: store barcode contents, list and search them @jurassicparkicecream (#14276)

Bug Fixes

• Fix: Set the ProcessedMail owner based on the rule owner in all cases @stumpylog (#14356)
• Fix: Ensure log rotation settings are converted to integers @stumpylog (#14343)
• Fix: Wrap apt calls into a retry so we can ideally jump a slow mirror @stumpylog (#14344) …

paperless-ngx 3.2.1

Bug Fixes

• Fix: only pass --conf to flower when flowerconfig.py exists @bitfoo1 (#14182)
• Fix: replace stale mail-fetch overlap check with a self-expiring lock @stumpylog (#14189)
• Fix: bump ocrmypdf to 17.12 to pick up the ligature text-layer fix @stumpylog (#14190)
• Fix: rebuild the search index automatically when it is missing Tantivy files @stumpylog (#14180)

Dependencies

• Chore(deps): Bump anyio from 4.12.1 to 4.14.2 in the uv group across 1 directory @dependabot[bot] (#14175)

All App Changes

<details> <summary>4 changes</summary>

• Chore(deps): Bump anyio from 4.12.1 to 4.14.2 in the uv group across 1 directory @dependabot[bot] (#14175)
• Fix: replace stale mail-fetch overlap check with a self-expiring lock @stumpylog (#14189)
• Fix: bump ocrmypdf to 17.12 to pick up the ligature text-layer fix @stumpylog (#14190) …

paperless-ngx 3.2.0

Features / Enhancements

• Enhancement (QoL): support deselecting single items from "select all" @shamoon (#14117)
• Enhancement: Match fuzzy terms in place inside the parsed query @stumpylog (#14157)
• Enhancement: Match CJK terms through their bigram fields in place @stumpylog (#14156)
• Enhancement: centralized management of share links + bundles @shamoon (#14115)
• Enhancement: parse advanced search with whoosh-compat and delete the handwritten translation @stumpylog (#14072)
• Enhancement: allow regex timeout configuration @shamoon (#14085)
• Enhancement: hide-able sidebar items @shamoon (#14052)
• Enhancement: Improve matching for correspondents, storage path and labels by removing bias + adding minimum match threshold @dewey (#12164)
• Enhancement: add Tantivy full-text fallback adapter for taxonomy candidates @stumpylog (#13820) …

paperless-ngx 3.1.3

Bug Fixes

• Fix: use the header loading indicator on tasks page @shamoon (#13949)
• Fix: fix load sidebar size animating @shamoon (#13947)
• Fix: wrap long words without spaces in dropdowns @shamoon (#13945)
• Fix: tweak tool calling localzation prompt @shamoon (#13943)
• Fix: skip vector store document id filter for unrestricted chat users @stumpylog (#13937)
• Fix: adopt the request stream when pinning an outbound host @ThomasSteinbach (#13927)
• Fix: ensure apply ai suggestions always runs after document created @shamoon (#13940)
• Fix: Handle failures when enqueuing files for consumption @stumpylog (#13935)
• Fix: Handle Celery mail task chord errors @stumpylog (#13936)
• Fix/chore: refactor some signal-backed conversion technical debt @shamoon (#13902) …

paperless-ngx 3.1.2

[!NOTE] This release addresses a security issue (GHSA-2jhj-xqrq-rmrq) and is recommended for all users. Our sincere thank you to the community members (and their LLMs) for reporting this.

Bug Fixes

• Fix: fix dark mode select disabled color, ensure disabled cursor on display mode dropdown @shamoon (#13881)
• Fix: add disable to the drag-drop list component @shamoon (#13880)

Documentation

• Chore: update screenshots for v3+ @shamoon (#13883)

All App Changes

<details> <summary>2 changes</summary>

• Fix: fix dark mode select disabled color, ensure disabled cursor on display mode dropdown @shamoon (#13881)
• Fix: add disable to the drag-drop list component @shamoon (#13880)

</details>

paperless-ngx 3.1.1

Bug Fixes

• Fix: 3.1.0 llm suggestions remove existing metadata from prompt, dont drop name suggestions @shamoon (#13866)
• Fix: set global search earlier to avoid awaiting debounce @shamoon (#13865)
• Fix: responsive sidebar, centralize and make sizes saner @shamoon (#13863)
• Tweak/fix: show existing count for ai suggestions @shamoon (#13861)
• Fix: 3.1.0 llm suggestions simplify schema, fix docstrings @shamoon (#13850)
• Fix: ensure ui reset of suggestionsLoading when changing docs @shamoon (#13840)
• Fix: always pass a non-empty api key for OpenAI-like servers @shamoon (#13838)
• Fix: hide slim sidebar scrollbar in browsers with stupid scrollbars @shamoon (#13837)
• Fix: correct sharelink bundle + document link permissions display bugs @shamoon (#13827)
• Fix: immediately re-add doc to index after trash restore @shamoon (#13818) …

paperless-ngx 3.1.0

Features / Enhancements

• Enhancement: Apply AI suggestions workflow action @shamoon (#13639)
• Enhancement: welcome widget visual tweaks @shamoon (#13794)
• Enhancement: support using remote OCR engines selectively @shamoon (#13633)
• Enhancement: websocket heartbeat @oktupol (#13739)
• Enhancement: more v3 ui tweaks @shamoon (#13774)
• Tweak: better support long list of views in documents list @shamoon (#13769)
• QoL: add count badge to versions dropdown @shamoon (#13753)
• Tweakhancement: add jitter to IMAP polling schedule @shamoon (#13734)
• Enhancement: sync OIDC groups to superuser and staff roles @BeSovereign (#13060)
• Enhancement: merge documents as versions @shamoon (#13515)
• Tweak: adjust modal proportions for small screens @shamoon (#13728) …

paperless-ngx 3.0.5

Bug Fixes

• Fix: accept Whoosh-era abbreviated relative-date units (yrs, mos, wks, etc) in search queries @stumpylog (#13486)
• Fix: fix edit dialog error change detection @shamoon (#13483)
• Fix: key the AI suggestion cache by model and endpoint @lunetics (#13449)
• Fix: validate custom field values in bulk operations @shamoon (#13457)
• Fixhancement: better handle empty fields from AI suggestions @shamoon (#13454)
• Fix: normalize monetary decimal symbol by locale @shamoon (#13427)
• Fix: fold overflowing path text in sanity checker @stumpylog (#13426)
• Fix: correct delayed add field button for custom fields @shamoon (#13424)
• Fix: hide attributes collapse / show button without UI settings @shamoon (#13425)
• Fix: consolidate born-digital PDF detection between archive decision and OCR @stumpylog (#13409) …

paperless-ngx 3.0.4

Bug Fixes

• Fix: prevent pdfjs highlight scrolling from affecting the entire page @shamoon (#13355)
• Fix: don't skip OCR/archive for tagged PDFs with no actual text @stumpylog (#13351)
• Performance: more efficient diacritic normalization in dropdown filtering @shamoon (#13347)
• Fix: dedupe permission-visible documents when combined with multi-tag filters @stumpylog (#13345)
• Fixhancement: pass LLM output language to chat if specified @shamoon (#13340)
• Fix: ensure preview reload on live changes @shamoon (#13321)
• Fix: clamp all out out-of-range possible fields @stumpylog (#13316)
• Fix: add docstring to DocumentClassifierSchema for cleaner LLM tool description @stumpylog (#13315)
• Fix: guard build_document_node against stale FK on deleted correspondent/doc type @stumpylog (#13318) …

paperless-ngx 3.0.3

Bug Fixes

• Fixhancement: PAPERLESS_ALLAUTH_TRUSTED_PROXY_COUNT @shamoon (#13281)
• Fix: preserve document fields during Gotenberg conversion to PDF @stumpylog (#13271)
• Fix: Makes the email date aware as soon as possible during parsing @stumpylog (#13266)
• Fix: Handle a plain string as Celery sometimes provides for the traceback @stumpylog (#13267)
• Fix: Emit the torch index into the requirements.txt for people still using it @stumpylog (#13265)
• Fix: handle notes without a user when building the search index @matthiasmast (#13260)

Documentation

• Docs: warn bare-metal users about stale files when upgrading @stumpylog (#13296)
• Documentation: Add the NumPy CPU baseline increase to the migration guide @stumpylog (#13269)

Maintenance

• Fix: Emit the torch index into the requirements.txt for people still using it @stumpylog (#13265)

All App Changes

<details> …

[!WARNING] An issue with database migrations prevents v3.0.1 from running, users should upgrade to v3.0.2

paperless-ngx 3.0.1

Bug Fixes

• Fix: selection_data re-derives the filtered document set 5 times over @stumpylog (#13229)
• Fix: exclude source document from its own RAG similarity results @stumpylog (#13233)
• Fix: split mailrule maximum_age clamp into its own migration @stumpylog (#13231)
• Chore: mark yes in confirm button for translation @shamoon (#13225)
• Fix: correct URL for W001 check @shamoon (#13220)
• Fix: ensure create dialog uses correct attribute type @shamoon (#13221)
• Fix: correct database engine from postgres to postgresql @OberstVonGatow (#13213)
• Fix: remove unnecessary .distinct() dominating document list queries @stumpylog (#13205)
• Fix: also wrap non-breaking words in chat messages, handle whitespace @shamoon (#13211) …

paperless-ngx 3.0.0

Breaking Changes

• [BREAKING] Remove the positional arguments from the pre/post consume scripts @stumpylog (#12573)
• [BREAKING] Decouple OCR control from archive file control @stumpylog (#12448)
• [BREAKING] Chore: drop support for api versions < 9 @shamoon (#12284)
• [BREAKING] Chore: Drop support for Python 3.10 @stumpylog (#12234)
• [BREAKING] Chore: Refactor advanced database settings to allow more user configuration @stumpylog (#12165)
• [BREAKING] Remove API v1 compatability @stumpylog (#12166)
• [BREAKING] Remove pybzar as a barcode reader @stumpylog (#12065)
• [BREAKING] Remove support for document and thumbnail encryption @stumpylog (#11850)
• [BREAKING] Feature: Simplify and improve the consumer @stumpylog (#11753)

Notable Changes

• Feature: Replace Whoosh with tantivy search backend @stumpylog (#12471) …

paperless-ngx 3.0.0-beta.rc2

Features / Enhancements

• docker-compose(deps): bump greenmail/standalone from 2.1.8 to 2.1.9 in /docker/compose @dependabot[bot] (#13067)
• docker-compose(deps): bump gotenberg/gotenberg from 8.33 to 8.34 in /docker/compose @dependabot[bot] (#13066)
• docker-compose(deps): bump nginx from 1.31.1-alpine to 1.31.2-alpine in /docker/compose @dependabot[bot] (#13065)
• docker(deps): Bump astral-sh/uv from 0.11.19-python3.12-trixie-slim to 0.11.28-python3.12-trixie-slim @dependabot[bot] (#13070)
• Chorehancement: update to Angular v22, 'zoneless' / 'reactive' @shamoon (#13114)
• Enhancement (beta): support LLM timeout config @shamoon (#13002)
• Enhancement: ignore diacritics, support multiple substring matching for UI filtering @shamoon (#13021) …