mirror of
https://github.com/coder/coder.git
synced 2026-06-03 13:08:25 +00:00
3362b5ae7e
When running `coder support bundle` inside a workspace without arguments, the command now infers the workspace and agent from the `CODER_WORKSPACE_NAME`, `CODER_WORKSPACE_OWNER_NAME`, and `CODER_WORKSPACE_AGENT_NAME` environment variables set by the workspace agent. Previously, running without arguments inside a workspace produced an incomplete bundle with no workspace info, agent logs, or connection diagnostics, despite the environment having all the information needed to resolve the current workspace. Also updates the usage string from `<workspace>` to `[<workspace>]` to reflect that the argument has always been optional. Closes #24615
2.6 KiB
Generated
2.6 KiB
Generated
support bundle
Generate a support bundle to troubleshoot issues connecting to a workspace.
Usage
coder support bundle [flags] [<workspace>] [<agent>]
Description
This command generates a file containing detailed troubleshooting information about the Coder deployment and workspace connections. You may specify a single workspace (and optionally an agent name). When run inside a workspace, the workspace and agent are inferred from the environment if not provided.
Options
-y, --yes
| Type | bool |
Bypass confirmation prompts.
-O, --output-file
| Type | string |
| Environment | $CODER_SUPPORT_BUNDLE_OUTPUT_FILE |
File path for writing the generated support bundle. Defaults to coder-support-$(date +%s).zip.
--url-override
| Type | string |
| Environment | $CODER_SUPPORT_BUNDLE_URL_OVERRIDE |
Override the URL to your Coder deployment. This may be useful, for example, if you need to troubleshoot a specific Coder replica.
--workspaces-total-cap
| Type | int |
| Environment | $CODER_SUPPORT_BUNDLE_WORKSPACES_TOTAL_CAP |
Maximum number of workspaces to include in the support bundle. Set to 0 or negative value to disable the cap. Defaults to 10.
--template
| Type | string |
| Environment | $CODER_SUPPORT_BUNDLE_TEMPLATE |
Template name to include in the support bundle. Use org_name/template_name if template name is reused across multiple organizations.
--pprof
| Type | bool |
| Environment | $CODER_SUPPORT_BUNDLE_PPROF |
Collect pprof profiling data from the Coder server and agent. Requires Coder server version 2.28.0 or newer.