Skip to content

Commit f53260b

Browse files
dvdksnclaude
andcommitted
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>
1 parent 41fb4e7 commit f53260b

File tree

1 file changed

+23
-2
lines changed

1 file changed

+23
-2
lines changed

content/manuals/ai/sandboxes/troubleshooting.md

Lines changed: 23 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -139,18 +139,39 @@ As a last resort, if `sbx reset` doesn't resolve your issue, you can remove the
139139
`sbx` state directory entirely. This deletes all sandbox data, configuration, and
140140
cached images. Stop all running sandboxes first with `sbx reset`.
141141

142-
macOS:
142+
{{< tabs >}}
143+
{{< tab name="macOS" >}}
143144

144145
```console
145146
$ rm -rf ~/Library/Application\ Support/com.docker.sandboxes/
146147
```
147148

148-
Windows:
149+
{{< /tab >}}
150+
{{< tab name="Windows" >}}
149151

150152
```powershell
151153
> Remove-Item -Recurse -Force "$env:LOCALAPPDATA\DockerSandboxes"
152154
```
153155

156+
{{< /tab >}}
157+
{{< tab name="Linux" >}}
158+
159+
Sandbox state on Linux follows the XDG Base Directory specification and is
160+
spread across three directories:
161+
162+
```console
163+
$ rm -rf ~/.local/state/sandboxes/
164+
$ rm -rf ~/.cache/sandboxes/
165+
$ rm -rf ~/.config/sandboxes/
166+
```
167+
168+
If you have set custom `XDG_STATE_HOME`, `XDG_CACHE_HOME`, or
169+
`XDG_CONFIG_HOME` environment variables, replace `~/.local/state`,
170+
`~/.cache`, and `~/.config` with the corresponding values.
171+
172+
{{< /tab >}}
173+
{{< /tabs >}}
174+
154175
## Report an issue
155176

156177
If you've exhausted the steps above and the problem persists, file a GitHub

0 commit comments

Comments
 (0)