You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
docs: add macOS Internet Sharing and Parallels Desktop conflicts for Boundary Client Agent (#5496)
* docs: add macOS Internet Sharing and Parallels Desktop conflicts for Boundary Client Agent
Updated the "Conflicting Software" section in the Boundary Client Agent documentation
to include issues caused by macOS Internet Sharing and Parallels Desktop (macOS VM with shared networking).
These configurations cause the system's DNS resolver to bind to port 53, preventing the Client Agent from starting.
* chore: change case of macOS to MacOS and added workaround for Parallels macOS VM conflict
* Apply suggestions from code review
approving style suggestions from code review
Co-authored-by: Dan Heath <[email protected]>
---------
Co-authored-by: Robin Beck <[email protected]>
Co-authored-by: Dan Heath <[email protected]>
Copy file name to clipboardExpand all lines: website/content/docs/api-clients/client-agent.mdx
+10Lines changed: 10 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -546,6 +546,16 @@ Docker Desktop sometimes creates a local DNS listener that prevents the Client A
546
546
If you run Docker Desktop 4.26 or later, you must clear the `Use kernel networking for UDP` option.
547
547
Otherwise, the Client Agent refuses to start.
548
548
549
+
### Internet Sharing (MacOS)
550
+
Enabling **Internet Sharing** on MacOS causes the system's DNS resolver (`mDNSResponder`) to bind to all interfaces on port 53, preventing the Client Agent from starting. Disable **Internet Sharing** before you run the Client Agent.
551
+
552
+
### Parallels Desktop (MacOS VM on MacOS Host)
553
+
Running a MacOS VM in Parallels Desktop with shared networking causes the system's DNS resolver (`mDNSResponder`) to bind to all interfaces, blocking port 53 and preventing the Client Agent from starting.
554
+
555
+
As a workaround, you can configure Parallels Desktop to use a different network mode.
556
+
Select an alternative network configuration such as **Host-Only**, **Default Adapter**, or **Wi-Fi** instead of **Shared Network**.
557
+
Refer to the Parallels Desktop documentation for more information.
558
+
549
559
### Palo Alto Networking Global Protect VPN
550
560
551
561
If you are unable to establish a transparent session while using the Palo Alto Networking Global Protect VPN, you may need to explicitly specify a network interface and the upstream DNS server(s) to use.
0 commit comments