From 619e2938578873491498253ec1c27b2a0c7cf05e Mon Sep 17 00:00:00 2001 From: Federico Jaramillo Martinez Date: Sun, 12 Jul 2026 23:10:10 +0200 Subject: [PATCH] docs: move archive upgrade note to changeset --- .changeset/honor-archive-data-dir.md | 2 ++ docs/config.md | 2 +- 2 files changed, 3 insertions(+), 1 deletion(-) diff --git a/.changeset/honor-archive-data-dir.md b/.changeset/honor-archive-data-dir.md index 705e87b..df07440 100644 --- a/.changeset/honor-archive-data-dir.md +++ b/.changeset/honor-archive-data-dir.md @@ -3,3 +3,5 @@ --- Store session archive metadata and archived session files under `PI_WEB_DATA_DIR` when configured. + +Previously, session archives always used `~/.pi-web`, even when `PI_WEB_DATA_DIR` selected another managed-state root. Existing archives created with a custom `PI_WEB_DATA_DIR` remain in `~/.pi-web` and are not migrated automatically. Before upgrading, stop the session daemon and back up both locations before reconciling them manually. Because the archive index stores absolute `archivePath` values, update those values when moving archived files. diff --git a/docs/config.md b/docs/config.md index b06bb9b..37e4840 100644 --- a/docs/config.md +++ b/docs/config.md @@ -131,7 +131,7 @@ Rows with JSON key `—` are runtime-only environment variables, not config-file The session daemon owns both archive locations. Restart the session daemon after setting or changing `PI_WEB_DATA_DIR`; restart the web/API process as well so its other managed-state stores use the same root. -PI WEB does not automatically migrate existing managed state. Archives created by earlier releases while a custom `PI_WEB_DATA_DIR` was already set may remain under `~/.pi-web` and will not appear automatically after upgrading. Stop the session daemon and back up both locations before reconciling them manually. The archive index stores absolute `archivePath` values, so update those values if archived files are moved to a different path. +PI WEB does not move existing managed state when `PI_WEB_DATA_DIR` changes. Stop the session daemon and back up the source and destination before moving archive data manually. The archive index stores absolute `archivePath` values, so update those values when archived files move to a different path. ### External path access