Generate a support bundle

To troubleshoot a deployment or workspace issue with Coder support, you can collect a support bundle from the CLI or VS Code. A support bundle is a ZIP archive of deployment, workspace, agent, and connection diagnostics.

Bundle contentsCopy Anchor Link

The CLI collects deployment and connection diagnostics, plus workspace and agent details when you specify a workspace. With workspace agent version 2.35.0 or later, agent logs include up to 10 MiB of the active log plus retained rotated logs modified in the last 24 hours, capped at 100 MiB in total. Older agents return only the active log. The lookback doesn't guarantee a full 24 hours of history because rotation can remove older logs. Additional workspace files are opt-in through --workspace-file. IDE integrations add their own diagnostics, which aren't included by the CLI alone.

Any authenticated user can generate a bundle. Your permissions, deployment configuration, and agent connectivity determine which data is available. Users with the Owner role get the most complete bundle; unavailable data can leave files empty or JSON values null.

Choose a collection method:

• CLI
• VS Code

Generate with the CLICopy Anchor Link

Use a machine on the network where you connect to your workspace so that the bundle captures that machine's connection diagnostics. Your Coder deployment must be available. A running, reachable workspace provides the most complete agent diagnostics.

1. Install the Coder CLI on your local machine.

2. Log in to your deployment.

3. Run the following command, replacing owner/workspace with your workspace's owner and name:

   Copy Text

   coder support bundle owner/workspace

4. Review the collection notice and enter yes to confirm.

The CLI saves coder-support-<timestamp>.zip in the current directory and prints Wrote support bundle to followed by its path. To select an agent in a workspace with multiple agents, append its name: coder support bundle owner/workspace agent-name. If you omit the workspace when running inside one, the CLI infers the workspace and agent from the environment. Network diagnostics then reflect the workspace rather than your local machine. Outside a workspace, omitting the workspace produces deployment and local network diagnostics without workspace-specific data.

Include workspace filesCopy Anchor Link

To include editor or service logs from the workspace, add one --workspace-file flag per path or glob. These files come from the remote workspace, not from the machine running the CLI. Workspace file collection requires Coder version 2.36.0 or later for both the CLI and the workspace agent. The workspace agent must be reachable.

Run the following command with the paths you want to collect. Quote each pattern so that your local shell doesn't expand it:

coder support bundle owner/workspace \
  --workspace-file '$HOME/.vscode-server/data/logs/**/*.log' \
  --workspace-file '$HOME/.local/share/code-server/coder-logs/**/*.log'

After confirmation, the CLI writes a ZIP archive with collected files under agent/workspace_files/files/. The agent/workspace_files/manifest.json file records requested patterns, collected files, errors, truncation, and limits. An agent that doesn't support collection records that limitation in the manifest instead of collecting the requested files.

The workspace agent evaluates paths and globs:

• Environment variables such as $HOME expand inside the workspace.
• Paths must resolve to absolute paths or start with ~/, which resolves to the agent user's home directory.
• Direct paths follow symlinks; glob traversal doesn't follow symlinks.
• Collection is limited to 10,000 files and 100 MiB in total.
• Each file contributes at most its last 10 MiB, or less if the total budget is nearly exhausted, with truncation recorded in the manifest.

Customize collectionCopy Anchor Link

Use these options to adjust the bundle:

For all options, refer to the coder support bundle reference.

Generate from your IDECopy Anchor Link

Use your IDE's collection action to include its local diagnostics alongside the Coder bundle. Running the CLI separately doesn't collect those local IDE files.

VS CodeCopy Anchor Link

Use the Coder Remote extension version 1.16.0 or later for this workflow. Sign in to your Coder deployment in the extension before collecting a bundle.

• Bundle generation requires Coder CLI version 2.10.0 or later.
• Remote editor server log collection requires Coder CLI and workspace agent v2.36.0 or later. The workspace agent must be reachable.

The extension normally manages the CLI for you. If you configure a custom CLI, ensure it meets these requirements.

1. Open the Command Palette.
2. Run Coder: Create Support Bundle.
3. If prompted, select a running workspace.
4. Review Create a support bundle? and select Continue.
5. Choose a local destination in Save Support Bundle. The extension confirms the saved archive's location and offers Reveal in File Explorer.
6. Review the archive before sharing it.

You can also open the context menu for a running workspace or one of its agents in the Coder sidebar and select Support Bundle. To target a specific agent when you aren't connected, start from that agent's context menu.

The extension runs coder support bundle and adds local diagnostics under vscode-logs/:

• Coder extension logs from recent windows and sessions.
• SSH proxy and Remote-SSH logs.
• Selected VS Code settings.
• Local telemetry files, when available.

Local log and telemetry collection includes files modified within the last 3 days, with at most the last 50 MiB of each file.

The extension masks configured values for coder.globalFlags, coder.headerCommand, and coder.tlsCertRefreshCommand. Other collected settings, including deployment URLs, TLS file paths, and SSH flags, are included unchanged. Review these values before sharing.

Extension version 1.16.1 or later adds session identifiers and logs workspace and agent state changes. With extension version 1.16.4 or later, bundles can include recent connection logs even if you didn't turn on debug logging. Collection is best effort, so the latest entries may be missing. To turn off buffering, set coder.connectionLogBuffer.size to 0.

Remote editor server logs appear under agent/workspace_files/, separately from the local VS Code diagnostics.

For telemetry controls and retention, refer to VS Code local telemetry. For extension installation and settings, refer to the Coder Remote README.

Review and share the bundleCopy Anchor Link

1. Extract the ZIP archive.
2. Review its contents and remove sensitive information before sharing.
3. Create a new ZIP archive from the reviewed contents.
4. Upload the reviewed archive through the link Coder support provides.

Include a description of the issue and any supporting files requested by Coder support.