From f53260ba82eafd3f9f264fd4135c2504050527a6 Mon Sep 17 00:00:00 2001
From: David Karlsson <35727626+dvdksn@users.noreply.github.com>
Date: Thu, 16 Apr 2026 10:24:27 +0200
Subject: [PATCH] Add Linux state paths to troubleshooting reset instructions

The "Removing all state" section only covered macOS and Windows.
Add a Linux tab documenting the XDG-based paths for sandbox state,
cache, and config directories.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 .../manuals/ai/sandboxes/troubleshooting.md   | 25 +++++++++++++++++--
 1 file changed, 23 insertions(+), 2 deletions(-)

diff --git a/content/manuals/ai/sandboxes/troubleshooting.md b/content/manuals/ai/sandboxes/troubleshooting.md
index 493a640dcaa..f86c5b7c4cc 100644
--- a/content/manuals/ai/sandboxes/troubleshooting.md
+++ b/content/manuals/ai/sandboxes/troubleshooting.md
@@ -139,18 +139,39 @@ As a last resort, if `sbx reset` doesn't resolve your issue, you can remove the
 `sbx` state directory entirely. This deletes all sandbox data, configuration, and
 cached images. Stop all running sandboxes first with `sbx reset`.
 
-macOS:
+{{< tabs >}}
+{{< tab name="macOS" >}}
 
 ```console
 $ rm -rf ~/Library/Application\ Support/com.docker.sandboxes/
 ```
 
-Windows:
+{{< /tab >}}
+{{< tab name="Windows" >}}
 
 ```powershell
 > Remove-Item -Recurse -Force "$env:LOCALAPPDATA\DockerSandboxes"
 ```
 
+{{< /tab >}}
+{{< tab name="Linux" >}}
+
+Sandbox state on Linux follows the XDG Base Directory specification and is
+spread across three directories:
+
+```console
+$ rm -rf ~/.local/state/sandboxes/
+$ rm -rf ~/.cache/sandboxes/
+$ rm -rf ~/.config/sandboxes/
+```
+
+If you have set custom `XDG_STATE_HOME`, `XDG_CACHE_HOME`, or
+`XDG_CONFIG_HOME` environment variables, replace `~/.local/state`,
+`~/.cache`, and `~/.config` with the corresponding values.
+
+{{< /tab >}}
+{{< /tabs >}}
+
 ## Report an issue
 
 If you've exhausted the steps above and the problem persists, file a GitHub