diff --git a/.env.example b/.env.example
index 194aef8b..f5da6611 100644
--- a/.env.example
+++ b/.env.example
@@ -92,9 +92,11 @@ SIGNUP_MODE=open
 # Where files are kept, such as tool results too large to hand a model whole:
 # postgres (the default, which keeps them in the database above, up to 100 MiB
 # each), or filesystem (files under BLOB_STORE_FILESYSTEM_ROOT, for a single
-# server with a disk of its own).
+# server with a disk of its own). A relative root is taken from where the API
+# runs, packages/server under `bun run dev`, so this one is the repository's
+# data/blobs.
 # BLOB_STORE_PROVIDER=postgres
-# BLOB_STORE_FILESYSTEM_ROOT=./data/blobs
+# BLOB_STORE_FILESYSTEM_ROOT=../../data/blobs
 # The largest file an agent's thread keeps, in bytes. Unset, only the blob
 # store's own limit applies.
 # THREAD_FILE_MAX_BYTES=104857600
diff --git a/.gitignore b/.gitignore
index 1a2df3f9..e0f5a7e0 100644
--- a/.gitignore
+++ b/.gitignore
@@ -8,5 +8,6 @@ coverage/
 !.env.example
 .temp/
 .claude/worktrees/
-# Files the filesystem blob store keeps, at .env.example's BLOB_STORE_FILESYSTEM_ROOT.
+# Files the filesystem blob store keeps, at .env.example's BLOB_STORE_FILESYSTEM_ROOT,
+# and wherever else a relative root puts them.
 data/