From 447feb06ccaf4367631d73a421a3a53be05110bb Mon Sep 17 00:00:00 2001 From: David Karlsson <35727626+dvdksn@users.noreply.github.com> Date: Thu, 21 May 2026 09:30:50 +0200 Subject: [PATCH] sandboxes: warn against mounting network drives Co-Authored-By: Claude Sonnet 4.6 --- content/manuals/ai/sandboxes/architecture.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/content/manuals/ai/sandboxes/architecture.md b/content/manuals/ai/sandboxes/architecture.md index 8361927496cc..0c7024d440c6 100644 --- a/content/manuals/ai/sandboxes/architecture.md +++ b/content/manuals/ai/sandboxes/architecture.md @@ -21,6 +21,12 @@ absolute paths means error messages, configuration files, and build outputs all reference paths you can find on your host. The agent sees exactly the directory structure you see, which reduces confusion when debugging or reviewing changes. +> [!WARNING] +> Avoid mounting network-attached or remote storage (network drives, SMB/NFS +> shares, or cloud-synced folders) as a workspace. The sandbox accesses +> workspaces through a filesystem passthrough, so every file read and write +> goes over the network. This adds latency and slows agent performance. + ## Storage and persistence When you create a sandbox, everything inside it persists until you remove it: