diff --git a/.env.example b/.env.example
index a4817c4..04b31e8 100644
--- a/.env.example
+++ b/.env.example
@@ -14,7 +14,13 @@ DATABASE_URL=mysql+asyncmy://model_platform:ChangeMe_MySQL_App_2026@mysql:3306/m
 #   - backend / runtime / schedule (passed through to boto3 / rclone)
 # RUSTFS_ACCESS_KEY / RUSTFS_SECRET_KEY are read by Python code in
 # backend/ and schedule/ (boto3 credentials).
+#
+# RustFS buckets are purpose-named. Currently we have:
+#   RUSTFS_WORKSPACE_BUCKET — workspace files (notebooks, scripts, working
+#     copies); layout is ``s3://<bucket>/<workspace_id>/...``.
+# Future: RUSTFS_VERSION_BUCKET, RUSTFS_RUN_LOG_BUCKET, ...
 RUSTFS_ENDPOINT=http://rustfs:9000
 RUSTFS_ACCESS_KEY=modelplatform
 RUSTFS_SECRET_KEY=ChangeMe_RustFS_2026
+RUSTFS_WORKSPACE_BUCKET=workspaces