From 6bb4bdb9cb03425bc293787ce23200711dcd55be Mon Sep 17 00:00:00 2001 From: Edward Angert Date: Wed, 26 Mar 2025 15:00:32 -0400 Subject: [PATCH] docs: add troubleshooting section to Desktop docs (#17098) [preview](https://coder.com/docs/@121-desktop-troubleshoot/user-guides/desktop) relates to https://github.com/coder/coder-desktop-macos/issues/121 --------- Co-authored-by: EdwardAngert <17991901+EdwardAngert@users.noreply.github.com> Co-authored-by: Ethan <39577870+ethanndickson@users.noreply.github.com> --- docs/user-guides/desktop/index.md | 32 +++++++++++++++++++++++++++++++ 1 file changed, 32 insertions(+) diff --git a/docs/user-guides/desktop/index.md b/docs/user-guides/desktop/index.md index 6879512ef6..abc3ae7ccd 100644 --- a/docs/user-guides/desktop/index.md +++ b/docs/user-guides/desktop/index.md @@ -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. + +## 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. + +
+ +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. + +