aboutsummaryrefslogtreecommitdiffstats
path: root/CLAUDE.md
diff options
context:
space:
mode:
Diffstat (limited to 'CLAUDE.md')
-rw-r--r--CLAUDE.md7
1 files changed, 7 insertions, 0 deletions
diff --git a/CLAUDE.md b/CLAUDE.md
index 2c745ae..4ccf70c 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -40,6 +40,13 @@ Debian. See README.md for usage; this file is the non-obvious context.
space then `*`); `cut -d' ' -f1` gets the hash. The script verifies it when
`sha256sum` is available, and validates the extracted tree before swapping.
+- **Extract the FULL zip, do NOT `unzip -x 'storage/*'`.** The zip's storage
+ skeleton provides `storage/framework/{cache,views,sessions}`, which Laravel
+ needs to boot. Excluding it and recreating only the data dirs makes artisan
+ die with the misleading `Target class [auth] does not exist` (the real boot
+ failure is masked by the exception reporter, which itself calls `auth()`).
+ Extract everything, then overlay live user data (uploads/exports/DB) on top.
+
## Conventions
- Config via env vars (`WORKDIR`, `INSTANCE`, `BACKUPDIR`), matching the