mirror of
https://github.com/coder/coder.git
synced 2026-09-21 20:51:01 +08:00
docs: add troubleshooting section to JetBrains Toolbox docs (#18394)
This commit is contained in:
@@ -55,3 +55,29 @@ To connect to a Coder deployment that uses internal certificates, configure the
|
||||
1. Select **Settings**.
|
||||
1. Add your certificate path in the **CA Path** field.
|
||||

|
||||
|
||||
## Troubleshooting
|
||||
|
||||
If you encounter issues connecting to your Coder workspace via JetBrains Toolbox, follow these steps to enable and capture debug logs:
|
||||
|
||||
### Enable Debug Logging
|
||||
|
||||
1. Open Toolbox
|
||||
1. Navigate to the **Toolbox App Menu (hexagonal menu icon) > Settings > Advanced**.
|
||||
1. In the screen that appears, select `DEBUG` for the Log level: section.
|
||||
1. Hit the back button at the top.
|
||||
1. Retry the same operation
|
||||
|
||||
### Capture Debug Logs
|
||||
|
||||
1. Access logs via **Toolbox App Menu > About > Show log files**.
|
||||
2. Locate the log file named `jetbrains-toolbox.log` and attach it to your support ticket.
|
||||
3. If you need to capture logs for a specific workspace, you can also generate a ZIP file using the Workspace action menu, available either on the main Workspaces page in Coder view or within the individual workspace view, under the option labeled **Collect logs**.
|
||||
|
||||
> [!Workspace]
|
||||
> Toolbox does not persist log level configuration between restarts.
|
||||
|
||||
## Additional Resources
|
||||
|
||||
- [JetBrains Toolbox documentation](https://www.jetbrains.com/help/toolbox-app)
|
||||
- [Coder JetBrains Toolbox Plugin Github](https://github.com/coder/coder-jetbrains-toolbox)
|
||||
|
||||
Reference in New Issue
Block a user