From b783f2eda936c51a3306936991c7d68916810515 Mon Sep 17 00:00:00 2001
From: EdwardAngert <17991901+EdwardAngert@users.noreply.github.com>
Date: Tue, 25 Mar 2025 21:33:13 +0000
Subject: [PATCH 1/4] add troubleshooting section
---
docs/user-guides/desktop/index.md | 31 +++++++++++++++++++++++++++++++
1 file changed, 31 insertions(+)
diff --git a/docs/user-guides/desktop/index.md b/docs/user-guides/desktop/index.md
index 6879512ef6774..e3438e2e5a3f4 100644
--- a/docs/user-guides/desktop/index.md
+++ b/docs/user-guides/desktop/index.md
@@ -193,3 +193,34 @@ 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
+
+> Internal Error: The VPN must be started with the app open during first-time setup.
+
+And
+
+> No workspaces!
+
+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.
+
+
From cf72b3bd1a354791872e57f05b05e8c0be0b82e6 Mon Sep 17 00:00:00 2001
From: Edward Angert
Date: Tue, 25 Mar 2025 23:25:11 -0400
Subject: [PATCH 2/4] Update docs/user-guides/desktop/index.md
Co-authored-by: Ethan <39577870+ethanndickson@users.noreply.github.com>
---
docs/user-guides/desktop/index.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/user-guides/desktop/index.md b/docs/user-guides/desktop/index.md
index e3438e2e5a3f4..7b22b1194b9ba 100644
--- a/docs/user-guides/desktop/index.md
+++ b/docs/user-guides/desktop/index.md
@@ -222,5 +222,5 @@ The resolution depends on which version of macOS you use:
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 the app, and follow the prompts to reinstall the network extension.
From dffdf7445bb36e36c85eace6476c92fb0a848751 Mon Sep 17 00:00:00 2001
From: Edward Angert
Date: Wed, 26 Mar 2025 14:52:34 -0400
Subject: [PATCH 3/4] swap error priority
---
docs/user-guides/desktop/index.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/docs/user-guides/desktop/index.md b/docs/user-guides/desktop/index.md
index 7b22b1194b9ba..bb4517376e882 100644
--- a/docs/user-guides/desktop/index.md
+++ b/docs/user-guides/desktop/index.md
@@ -198,11 +198,11 @@ We are planning some changes to Coder Desktop that will make accessing secure co
### Mac: Issues updating Coder Desktop
-> Internal Error: The VPN must be started with the app open during first-time setup.
+> No workspaces!
And
-> No workspaces!
+> 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.
From ff90130b23107192176104f645ffb15c79d09cbb Mon Sep 17 00:00:00 2001
From: Edward Angert
Date: Wed, 26 Mar 2025 14:54:49 -0400
Subject: [PATCH 4/4] md fix
---
docs/user-guides/desktop/index.md | 3 ++-
1 file changed, 2 insertions(+), 1 deletion(-)
diff --git a/docs/user-guides/desktop/index.md b/docs/user-guides/desktop/index.md
index bb4517376e882..abc3ae7ccd050 100644
--- a/docs/user-guides/desktop/index.md
+++ b/docs/user-guides/desktop/index.md
@@ -222,5 +222,6 @@ The resolution depends on which version of macOS you use:
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 the app, and follow the prompts to reinstall the network extension.
+1. Re-open Coder Desktop and follow the prompts to reinstall the network extension.
+