Skip to content

Commit f2c84ad

Browse files
Mohit0233stellarsquallDan-Heath
authored
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]>
1 parent 1820d43 commit f2c84ad

File tree

1 file changed

+10
-0
lines changed

1 file changed

+10
-0
lines changed

website/content/docs/api-clients/client-agent.mdx

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -546,6 +546,16 @@ Docker Desktop sometimes creates a local DNS listener that prevents the Client A
546546
If you run Docker Desktop 4.26 or later, you must clear the `Use kernel networking for UDP` option.
547547
Otherwise, the Client Agent refuses to start.
548548

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+
549559
### Palo Alto Networking Global Protect VPN
550560

551561
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

Comments
 (0)