Upgrade Path

Paperless-ngx 2.16.0 → 2.17.0

4 versions, 1 with breaking changes, 2 with upstream notes or warnings only (1 repeats an earlier entry), 0 required stops

Version by version, oldest first

2.16.1 2025-05-19

Note

Mariadb users may experience a database migration problem in 2.16.0–2.16.1 and should skip this version and upgrade directly to at least v2.16.2

Warning

Django 5.2 removed support for PostgreSQL 13 and thus support will be removed in a future Paperless-ngx version. Users may want to upgrade now, see https://docs.paperless-ngx.com/administration/#database-upgrades

Full release notes for 2.16.1

2.16.2 2025-05-24

Warning

Same text as in 2.16.1, above.

Full release notes for 2.16.2

2.16.3: no action items (1 version)

2.17.0 2025-06-19

Breaking

  • Fix: restore expected pre-2.16 scheduled workflow offset behavior @shamoon (#10218)

Warning

In versions v2.16.0–v2.16.3, the interpretation of offset days for scheduled workflows was inverted. This has now been corrected to restore the intuitive, pre-v2.16 behavior:

  • Positive offsets now trigger workflows after the date
  • Negative offsets trigger workflows before the date

If you configured scheduled workflows in v2.16.x with inverted offsets (or adjusted a trigger created in 2.15.x), you must now adjust the offset sign to match this corrected logic.

If you did not alter your workflow triggers after upgrading from v2.15, no changes are required.

We apologize for the confusion — this fix restores consistency and better matches user expectations.

Full release notes for 2.17.0

Release notes from github.com/paperless-ngx/paperless-ngx/releases, and docs/changelog.md, checked 17 hours ago. Only text the vendor marks as breaking, or puts in a warning/caution/important note, or a plain note, is shown (a note that only announces a security fix is not); read the full notes for anything else.