Files
paperless-ngx/docs/migration.md

2.1 KiB

v3 Migration Guide

Consumer Settings Changes

The v3 consumer command uses a different library to unify the watching for new files in the consume directory. For the user, this removes several configuration options related to delays and retries and replaces with a single unified setting. It also adjusts how the consumer ignore filtering happens, replaced fnmatch with regex and separating the directory ignore from the file ignore.

Summary

Old Setting New Setting Notes
CONSUMER_POLLING CONSUMER_POLLING_INTERVAL Renamed for clarity
CONSUMER_INOTIFY_DELAY CONSUMER_STABILITY_DELAY Unified for all modes
CONSUMER_POLLING_DELAY Removed Use CONSUMER_STABILITY_DELAY
CONSUMER_POLLING_RETRY_COUNT Removed Automatic with stability tracking
CONSUMER_IGNORE_PATTERNS CONSUMER_IGNORE_PATTERNS Now regex, not fnmatch; user patterns are added to (not replacing) default ones
New CONSUMER_IGNORE_DIRS Additional directories to ignore; user entries are added to (not replacing) defaults