$ ls ~/releases/paperless-ngx

Paperless-ngx upgrade guide

Before you upgrade Paperless-ngx, check what happened when we did. We install the previous version in a throwaway lab (Ubuntu 26.04 VM), add some data, upgrade the documented way, and record what broke and what didn't. We cover every stable release. Upstream releases: paperless-ngx/paperless-ngx.

latest tested3.5.0upgrade now

Clean Docker upgrade from 3.4.2 in our lab with data intact; check PAPERLESS_ALLOWED_HOSTS only if you set it.

versions covered
2
lab-tested
2
last lab run
2026-11-17

all Paperless-ngx releases we tested

  1. 3.5.0Clean Docker upgrade from 3.4.2 in our lab with data intact; check PAPERLESS_ALLOWED_HOSTS only if you set it.upgrade now
  2. 3.4.2A clean bug-fix and dependency update; the Docker upgrade from 3.4.1 went smoothly in our lab.upgrade now