Skip to content

~95% on SimpleQA (e.g. Qwen3.6-27B on a 3090). Supports all local and cloud LLMs (llama.cpp, Ollama, Google, ...). 10+ search engines - arXiv, PubMed, your private documents. Everything Local & Encrypted.

docs: clarify v2 backup retention and library path upgrades (#7224)

LearningCircuitd3df46e6388d
diff --git a/changelog.d/6335.breaking.md b/changelog.d/6335.breaking.md
new file mode 100644
index 0000000000..1c19c46370
--- /dev/null
+++ b/changelog.d/6335.breaking.md
@@ -0,0 +1,9 @@
+**The research-library storage location is now operator-managed.** User settings
+saves, imports, resets and deletes cannot change `research_library.storage_path`;
+single-setting API updates and deletes return 403. Configure
+`LDR_RESEARCH_LIBRARY_STORAGE_PATH` for operator overrides. Existing saved paths,
+including locations outside `LDR_DATA_DIR`, and the shipped
+`~/Documents/LocalDeepResearch/Library` default remain in use. Changing the
+override does not move existing files. Review saved paths before upgrading a
+multi-user installation; see the
+[upgrade guide](https://github.com/LearningCircuit/local-deep-research/blob/main/docs/deployment/upgrading.md).
diff --git a/docs/deployment/upgrading.md b/docs/deployment/upgrading.md
index 8e6111866d..1cde2b2a7b 100644
--- a/docs/deployment/upgrading.md
+++ b/docs/deployment/upgrading.md
@@ -22,6 +22,15 @@ unzip -l local_deep_research-*.whl | grep 'database/migrations/versions/0'
## Before upgrading
+Review saved library locations, especially on multi-user installations.
+`research_library.storage_path` is now operator-managed. Existing saved paths
+and the shipped `~/Documents/LocalDeepResearch/Library` default stay in use,
+including locations outside `LDR_DATA_DIR`. User settings saves, imports,
+resets and deletes cannot change this path; single-setting API updates and
+deletes return 403. Set `LDR_RESEARCH_LIBRARY_STORAGE_PATH` in the deployment
+configuration to override it. Changing that value does not move existing files.
+See the [configuration reference](../CONFIGURATION.md).
+
1. Record the installed package version or image digest and retain its
deployment configuration. Use the selected release's dependencies when
upgrading or rolling back; a newer lockfile does not describe the old release.