Skip to content

docs: add troubleshooting section to Desktop docs #17098

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 4 commits into from
Mar 26, 2025
Merged

docs: add troubleshooting section to Desktop docs #17098

Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
b783f2e
add troubleshooting section
EdwardAngert Mar 25, 2025
cf72b3b
Update docs/user-guides/desktop/index.md
EdwardAngert Mar 26, 2025
dffdf74
swap error priority
EdwardAngert Mar 26, 2025
ff90130
md fix
EdwardAngert Mar 26, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
32 changes: 32 additions & 0 deletions docs/user-guides/desktop/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -193,3 +193,35 @@ We are planning some changes to Coder Desktop that will make accessing secure co
1. Web apps accessed on the configured hostnames will now function correctly in a secure context without requiring a restart.

</div>

## Troubleshooting

### Mac: Issues updating Coder Desktop

> No workspaces!

And

> Internal Error: The VPN must be started with the app open during first-time setup.

Due to an issue with the way Coder Desktop works with the macOS [interprocess communication mechanism](https://developer.apple.com/documentation/xpc)(XPC) system network extension, core Desktop functionality can break when you upgrade the application.

<div class="tabs">

The resolution depends on which version of macOS you use:

### macOS <=14

1. Delete the application from `/Applications`.
1. Restart your device.

### macOS 15+

1. Open **System Settings**
1. Select **General**
1. Select **Login Items & Extensions**
1. Scroll down, and select the **ⓘ** for **Network Extensions**
1. Select the **...** next to Coder Desktop, then **Delete Extension**, and follow the prompts.
1. Re-open Coder Desktop and follow the prompts to reinstall the network extension.

</div>