paradizelost/paperless-ngx
1
0
Fork 0
mirror of https://github.com/paperless-ngx/paperless-ngx.git synced 2025-04-02 13:45:10 -05:00
Code Issues Packages Projects Releases Wiki Activity

Add 2 warnings about potential path length issues

Browse Source
This commit is contained in:
Trenton H 2023-01-12 12:48:54 -08:00
parent b25f083687
commit c9683808c9
2 changed files with 14 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
docs/administration.md
View File

@ -267,6 +267,12 @@ The filenames generated by this command follow the format
paperless to use `PAPERLESS_FILENAME_FORMAT` for exported filenames paperless to use `PAPERLESS_FILENAME_FORMAT` for exported filenames
instead, specify `--use-filename-format`. instead, specify `--use-filename-format`.
!!! warning
If exporting with the file name format, there may be errors due to
your operating system's maximum path lengths. Try adjusting the export
target or consider not using the filename format.
### Document importer {#importer} ### Document importer {#importer}
The document importer takes the export produced by the [Document The document importer takes the export produced by the [Document

9
docs/advanced_usage.md
View File

@ -336,6 +336,13 @@ value.
However, keep in mind that inside docker, if files get stored outside of However, keep in mind that inside docker, if files get stored outside of
the predefined volumes, they will be lost after a restart of paperless. the predefined volumes, they will be lost after a restart of paperless.
!!! warning
When file naming handling, in particular when using `{tag_list}`,
you may run into the limits of your operating system's maximum
path lengths. Files will retain the previous path instead and
the issue logged.
## Storage paths ## Storage paths
One of the best things in Paperless is that you can not only access the One of the best things in Paperless is that you can not only access the
@ -392,7 +399,7 @@ structure as in the previous example above.
If you adjust the format of an existing storage path, old documents If you adjust the format of an existing storage path, old documents
don't get relocated automatically. You need to run the don't get relocated automatically. You need to run the
[document renamer](/administration#renamer) to [document renamer](/administration#renamer) to
adjust their pathes. adjust their paths.
## Celery Monitoring {#celery-monitoring} ## Celery Monitoring {#celery-monitoring}