From f899832c0250d727f8219accb281e2afaf36d9ea Mon Sep 17 00:00:00 2001
From: Ethan <39577870+ethanndickson@users.noreply.github.com>
Date: Thu, 13 Mar 2025 14:45:37 +1100
Subject: [PATCH] docs: add warning for multiple Coder Desktop mac
 installations (#16888)

I realised we should advise against installing multiple copies, as I'm sure someone will try and get confused by Apple's obtuse error messaging.

Tailscale also has a similar warning: https://pkgs.tailscale.com/stable/#macos
---
 docs/user-guides/desktop/index.md | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/docs/user-guides/desktop/index.md b/docs/user-guides/desktop/index.md
index 83963480c0..dbb2201de9 100644
--- a/docs/user-guides/desktop/index.md
+++ b/docs/user-guides/desktop/index.md
@@ -34,6 +34,11 @@ You can install Coder Desktop on macOS or Windows.
 
 1. Continue to the [configuration section](#configure).
 
+> [!IMPORTANT]
+> Do not install more than one copy of Coder Desktop.
+>
+> To avoid system VPN configuration conflicts, only one copy of `Coder Desktop.app` should exist on your Mac, and it must remain in `/Applications`.
+
 ### Windows
 
 1. Download the latest `CoderDesktop` installer executable (`.exe`) from the [coder-desktop-windows release page](https://github.com/coder/coder-desktop-windows/releases).