From fe2453f688133c4dd64fcddd30c22026cba7170b Mon Sep 17 00:00:00 2001 From: David Karlsson <35727626+dvdksn@users.noreply.github.com> Date: Thu, 27 Aug 2026 09:58:12 +0000 Subject: [PATCH 1/3] docs: document automatic diagnostics uploads The v0.42 release adds consent-based diagnostics uploads for selected daemon errors. Document the prompt, setting, bundle handling, and distinction from manual uploads. Co-Authored-By: Claude --- .../manuals/ai/sandboxes/troubleshooting.md | 30 ++++++++++++++++++- 1 file changed, 29 insertions(+), 1 deletion(-) diff --git a/content/manuals/ai/sandboxes/troubleshooting.md b/content/manuals/ai/sandboxes/troubleshooting.md index fc518e40ebf..e982eed59f5 100644 --- a/content/manuals/ai/sandboxes/troubleshooting.md +++ b/content/manuals/ai/sandboxes/troubleshooting.md @@ -377,6 +377,32 @@ If you have set custom `XDG_STATE_HOME`, `XDG_CACHE_HOME`, or {{< /tab >}} {{< /tabs >}} +## Control automatic diagnostics uploads + +Docker Sandboxes can collect and upload a diagnostics bundle to Docker support +after certain internal daemon errors. Automatic uploads require your consent. +When the feature is available and you haven't stored a preference, an +interactive `sbx` command prompts for consent after the command finishes. +Answer `yes` to opt in. Answer `no` or press Enter to decline. Docker +Sandboxes stores your answer and doesn't prompt again. + +Without a stored preference, non-interactive commands and commands running +with `CI=true` or `DOCKER_CI=true` neither prompt nor upload. To set or change +your preference directly, run: + +```console +$ sbx settings set diagnostics.autoUpload yes +``` + +Replace `yes` with `no` to turn off automatic uploads. Turning off automatic +uploads also discards any bundles queued for upload. + +Automatic bundles contain basic system information and Docker Sandboxes +client, daemon, crash, and MCP logs. Docker Sandboxes obfuscates known identity +values and credential formats in collected logs, but logs can still contain +user content. If an upload fails, Docker Sandboxes keeps the bundle in a local +queue for a later retry. + ## Report an issue If you've exhausted the steps above and the problem persists, file a GitHub @@ -392,4 +418,6 @@ $ sbx diagnose --upload The bundle contains daemon logs, diagnostic check results, and basic system information. When `--upload` is confirmed, the bundle is uploaded to Docker support and the command prints a diagnostics ID. Include this ID in your -issue so the team can correlate it with the uploaded bundle. +issue so the team can correlate it with the uploaded bundle. This manual +upload is separate from the automatic upload preference: the command saves a +local bundle and asks for confirmation each time. From 6bd3cd04458897ef13896d6316e7e069f6b7d97a Mon Sep 17 00:00:00 2001 From: Codex Date: Thu, 27 Aug 2026 11:39:14 +0000 Subject: [PATCH 2/3] docs: clarify diagnostics upload wording --- .../manuals/ai/sandboxes/troubleshooting.md | 20 +++++++++---------- 1 file changed, 9 insertions(+), 11 deletions(-) diff --git a/content/manuals/ai/sandboxes/troubleshooting.md b/content/manuals/ai/sandboxes/troubleshooting.md index e982eed59f5..ac00cd8042a 100644 --- a/content/manuals/ai/sandboxes/troubleshooting.md +++ b/content/manuals/ai/sandboxes/troubleshooting.md @@ -379,12 +379,11 @@ If you have set custom `XDG_STATE_HOME`, `XDG_CACHE_HOME`, or ## Control automatic diagnostics uploads -Docker Sandboxes can collect and upload a diagnostics bundle to Docker support -after certain internal daemon errors. Automatic uploads require your consent. -When the feature is available and you haven't stored a preference, an -interactive `sbx` command prompts for consent after the command finishes. -Answer `yes` to opt in. Answer `no` or press Enter to decline. Docker -Sandboxes stores your answer and doesn't prompt again. +After certain daemon errors, Docker Sandboxes can collect and upload a +diagnostics bundle to Docker Support. Automatic uploads require your consent. +If you haven't saved a preference, an interactive `sbx` command prompts after +it finishes. Enter `yes` to opt in, or enter `no` or press Enter to decline. +Docker Sandboxes saves your choice and doesn't prompt again. Without a stored preference, non-interactive commands and commands running with `CI=true` or `DOCKER_CI=true` neither prompt nor upload. To set or change @@ -397,11 +396,10 @@ $ sbx settings set diagnostics.autoUpload yes Replace `yes` with `no` to turn off automatic uploads. Turning off automatic uploads also discards any bundles queued for upload. -Automatic bundles contain basic system information and Docker Sandboxes -client, daemon, crash, and MCP logs. Docker Sandboxes obfuscates known identity -values and credential formats in collected logs, but logs can still contain -user content. If an upload fails, Docker Sandboxes keeps the bundle in a local -queue for a later retry. +Automatic bundles include basic system information and client, daemon, crash, +and MCP logs. Docker Sandboxes redacts recognized identity values and +credential patterns, but collected logs can still contain user content. Failed +uploads remain in a local queue for a later retry. ## Report an issue From e6cf8b5d78d373be2c7fe9ff7591c25e4fd30684 Mon Sep 17 00:00:00 2001 From: Codex Date: Thu, 27 Aug 2026 14:40:55 +0000 Subject: [PATCH 3/3] docs: simplify automatic diagnostics guidance --- .../manuals/ai/sandboxes/troubleshooting.md | 19 +++---------------- 1 file changed, 3 insertions(+), 16 deletions(-) diff --git a/content/manuals/ai/sandboxes/troubleshooting.md b/content/manuals/ai/sandboxes/troubleshooting.md index ac00cd8042a..5b53be9e7b9 100644 --- a/content/manuals/ai/sandboxes/troubleshooting.md +++ b/content/manuals/ai/sandboxes/troubleshooting.md @@ -377,25 +377,14 @@ If you have set custom `XDG_STATE_HOME`, `XDG_CACHE_HOME`, or {{< /tab >}} {{< /tabs >}} -## Control automatic diagnostics uploads +## Enable automatic diagnostics uploads -After certain daemon errors, Docker Sandboxes can collect and upload a -diagnostics bundle to Docker Support. Automatic uploads require your consent. -If you haven't saved a preference, an interactive `sbx` command prompts after -it finishes. Enter `yes` to opt in, or enter `no` or press Enter to decline. -Docker Sandboxes saves your choice and doesn't prompt again. - -Without a stored preference, non-interactive commands and commands running -with `CI=true` or `DOCKER_CI=true` neither prompt nor upload. To set or change -your preference directly, run: +To opt in to automatic diagnostics uploads after certain daemon errors, run: ```console $ sbx settings set diagnostics.autoUpload yes ``` -Replace `yes` with `no` to turn off automatic uploads. Turning off automatic -uploads also discards any bundles queued for upload. - Automatic bundles include basic system information and client, daemon, crash, and MCP logs. Docker Sandboxes redacts recognized identity values and credential patterns, but collected logs can still contain user content. Failed @@ -416,6 +405,4 @@ $ sbx diagnose --upload The bundle contains daemon logs, diagnostic check results, and basic system information. When `--upload` is confirmed, the bundle is uploaded to Docker support and the command prints a diagnostics ID. Include this ID in your -issue so the team can correlate it with the uploaded bundle. This manual -upload is separate from the automatic upload preference: the command saves a -local bundle and asks for confirmation each time. +issue so the team can correlate it with the uploaded bundle.