From 254278e382ffd331b26461567100ea299dd44f74 Mon Sep 17 00:00:00 2001 From: Sander Date: Wed, 27 Mar 2024 23:27:28 +0100 Subject: [PATCH] reinforce shamoons comment in https://github.com/paperless-ngx/paperless-ngx/discussions/4604#discussioncomment-7595710, because I wrecked a sample database by importing an export from another sample database --- docs/administration.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/docs/administration.md b/docs/administration.md index 1fa92cb7d..77fb05bd4 100644 --- a/docs/administration.md +++ b/docs/administration.md @@ -357,6 +357,16 @@ extract the files inside the `export` folder first. Importing from a previous version of Paperless may work, but for best results it is suggested to match the versions. + +!!! warning + The [Document importer](#importer) is meant to be run against a completely empty database + and a set of empty paperless folders. + Unless you take great care in making sure that there will be no collisions + (with the existing items in your paperless database) caused by the manifest data you + place in the `export` folder, the document_importer script may crash on duplicate items/files. + You run the risk of corrupting your target paperless instance if you import + items into a paperless instance that is not completely empty. + ### Document retagger {#retagger}