Version path: 2.10.1* → 2.5.0 env vars → 2.9.0 → 2.18.0 → 2.20.13
Existing Issues:
*Current appVersion is 2.10.1 but artifacthub.io/images incorrectly references 2.4.0 — fix both atomically.
2.5.0 added OIDC/social auth (high-demand for K8s users)
2.9.0 added scheduled workflow cron config
2.18.0 enforces PostgreSQL 14 minimum and adds DB connection pool config
2.20.7 security fix restricts filename template context — users with custom PAPERLESS_FILENAME_FORMAT should run document_renamer after upgrading
2.20.x series has 8+ security CVE fixes — all users should update promptly
Changes required (fix annotation first, then chronological):
Version path:
2.10.1* →2.5.0env vars →2.9.0→2.18.0→2.20.13Existing Issues:
PAPERLESS_REDIRECT_LOGIN_TO_SSOis still used and supported. if so add the support for it as descirbed in [paperless-ngx] Missing configuration option #35*Current
appVersionis2.10.1butartifacthub.io/imagesincorrectly references2.4.0— fix both atomically.2.5.0added OIDC/social auth (high-demand for K8s users)2.9.0added scheduled workflow cron config2.18.0enforces PostgreSQL 14 minimum and adds DB connection pool config2.20.7security fix restricts filename template context — users with customPAPERLESS_FILENAME_FORMATshould rundocument_renamerafter upgrading2.20.xseries has 8+ security CVE fixes — all users should update promptlyChanges required (fix annotation first, then chronological):
artifacthub.io/imagesfrom2.4.0→2.20.13and alignappVersion2.5.0— Add OIDC/social auth section:PAPERLESS_APPS,PAPERLESS_SOCIALACCOUNT_PROVIDERS,PAPERLESS_SOCIAL_AUTO_SIGNUP,PAPERLESS_SOCIALACCOUNT_ALLOW_SIGNUPS,PAPERLESS_ACCOUNT_ALLOW_SIGNUPS,PAPERLESS_DISABLE_REGULAR_LOGIN,PAPERLESS_REDIRECT_LOGIN_TO_SSO2.6.0–2.8.x— Add SMTP email section:PAPERLESS_EMAIL_HOST/PORT/HOST_USER/HOST_PASSWORD/USE_TLS/USE_SSL; addPAPERLESS_AUDIT_LOG_ENABLED2.9.0— AddPAPERLESS_WORKFLOW_SCHEDULE_CRON2.11.0–2.13.x— AddPAPERLESS_ACCOUNT_SESSION_REMEMBER,PAPERLESS_SESSION_COOKIE_AGE2.18.0— AddPAPERLESS_DB_CONNECTION_POOL_SIZE; ensure bundled PostgreSQL subchart is version 14+2.20.7filename template restriction: users with customPAPERLESS_FILENAME_FORMATshould rundocument_renamerafter upgradingbitnami/postgresqlandbitnami/redissubchart image overrides are in place (covered by General Changes issue)appVersionand image tag to2.20.13versionto1.0.0