docs: explain eCryptfs image-pull failures

Image pulls on Linux can fail with an I/O error when sandbox state is on eCryptfs. Add troubleshooting guidance that identifies the diagnostic warning and recommends another filesystem for state.
This commit is contained in:
David Karlsson committed 2026-10-27 12:22:13 +00:00
1 parent 901bf91e15
commit d1f4f58bd5
1 file changed
+8
@@ -28,6 +28,14 @@ with suggested fixes. Use `--json` or `--format yaml` for machine-readable
output, or `--format github-issue` to generate a Markdown snippet suitable for pasting
into a GitHub issue.
## Image pulls fail on eCryptfs
On Linux, image pulls can fail with an I/O error when the sandbox state
directory is on eCryptfs.
If [`sbx diagnose`](#run-diagnostics) reports `state directory is on eCryptfs`,
use a filesystem other than eCryptfs for sandbox state.
## Sandbox is not responding
If `sbx ls` shows `running (not responding)`, Docker Sandboxes has detected