Updated on March 8, 2026 Published on November 7, 2022 in How to, Troubleshooting

Bomgar Not Working On Mac: Main Causes and Solutions

Helga York Article author

HelpWire
→
Blog
→
Bomgar Not Working on Mac

When BeyondTrust (Bomgar) not working on macOS, it almost always falls into one of four failure patterns: the technician connects but sees a black or blank screen instead of the desktop; the screen is visible but the mouse and keyboard won’t respond to remote control; the support client refuses to launch at all; or, in unattended deployments, Jump Clients keep dropping offline in the management console.

The good news is that most of these failures trace back to a single root cause, macOS privacy enforcement, and once you understand how Bomgar Mac permissions work, the fixes are fast and logical. This guide walks through every scenario on why Bomgar is not working on Mac, systematically, starting with the most common..

Quick Diagnosis: Find Your Symptom First

What you’re seeing	Most likely cause
Black or blank screen during session	Screen Recording permission missing or not applied after restart
Screen visible, but can’t click or type	Accessibility permission missing
Session won’t start / client won’t launch	Gatekeeper block, filtered download, network/proxy restriction, or outdated client build
Jump Client shows offline in console	Post-upgrade version drift or proxy detection issue

Alternative: If you’re still facing issues with BeyondTrust after trying all the fixes, you might want to consider an alternative like HelpWire. It offers stable and secure remote access across Windows, macOS, and Linux. For a better solution, check out the Alternative Solution section, or keep reading for more troubleshooting tips.

When Bomgar screen sharing stops working on macOS, the session typically connects, but macOS silently blocks screen capture or input control behind the scenes. The result is a black or blank screen on the technician’s end, or a visible desktop the technician can see but not interact with.

The culprit is Apple’s Transparency, Consent, and Control (TCC) framework, introduced with macOS Catalina, which requires explicit user approval before any app can capture screen contents or control keyboard and mouse input. When these Bomgar mac permissions are missing or haven’t been re-applied after a client restart, macOS blocks the data without any obvious error, the user’s screen looks completely normal, which is exactly what makes this so frustrating to diagnose.

The fix is almost always the same: grant the correct permissions to the Remote Support Customer Client, then fully quit and relaunch it.

Three Bomgar Mac permissions matter:

Screen Recording (“Screen & System Audio Recording” on Ventura and later) — without it, BeyondTrust captures blank frames, causing the black screen.

Accessibility — enables remote keyboard and mouse control. Without it, the technician can see the screen but can’t interact with it.

Full Disk Access — only needed when IT requires access to protected system directories. Most sessions don’t need it.

This resolves both the black screen and unresponsive controls problems. Steps differ slightly by macOS version.

Step 1: Open Privacy Settings
If BeyondTrust displays an “Action Required” prompt, click “Open System Preferences” — it takes you directly to the relevant permission panel. If no prompt appears, navigate there manually:
• macOS Ventura, Sonoma, or Sequoia (13, 14, 15): Apple menu → System Settings → Privacy & Security
• macOS Monterey, Big Sur, or Catalina (12, 11, 10.15): Apple menu → System Preferences → Security & Privacy → Privacy tab. Click the lock icon to make changes.
Step 2: Enable Screen Recording (Fixes the Black Screen)
• macOS Ventura, Sonoma, or Sequoia (13, 14, 15): System Settings → Privacy & Security → Screen & System Audio Recording → enable the toggle next to “Remote Support Customer Client” or your organization’s branded client.
• macOS Monterey, Big Sur, or Catalina (12, 11, 10.15): System Preferences → Security & Privacy → Privacy tab → Screen Recording → check the box next to the BeyondTrust client entry.
Step 3: Enable Accessibility (Fixes Unresponsive Controls)
In the same Privacy area, open Accessibility and enable the same BeyondTrust client entry. This permission allows the remote technician to drive the keyboard and mouse.
Step 4: Quit and Relaunch the Client
This step is non-negotiable. macOS will often display a warning that the app “will not be able to record until it is quit.” Take that literally — close the Remote Support Customer Client completely, restart the support link, and reopen the session. Permission changes do not apply to a running process.

Optional: Full Disk Access

Only enable this when your IT team specifically requests it. Restart the remote session after granting it.

Note: macOS 15 asks users to reconfirm BeyondTrust’s screen recording permission every 30 days. When the prompt appears, choose “Allow for One Month”, dismissing or denying it will immediately cause a black screen, even if System Settings still shows the permission as active. If a working session suddenly goes blank, this is the first thing to check.

When Bomgar Mac permissions are correctly configured but sessions still fail, drop unexpectedly, or display heavy lag, the problem is almost certainly network-related. Solutions

• Check basic reachability first. Open a browser on the affected Mac and try to load the BeyondTrust support portal URL directly. If it doesn’t load, the issue is upstream, DNS resolution, a captive portal, or an egress filtering policy is blocking the connection before BeyondTrust gets involved.
• Verify outbound port access. BeyondTrust remote support requires outbound TCP 443 in all deployments. TCP 80 may also be used depending on your portal configuration. A firewall or corporate proxy silently blocking these ports will cause sessions to connect and then immediately stall.
• Check endpoint security software. Local firewalls and endpoint protection tools can intercept the BeyondTrust client process from downloading session components or maintaining the connection. If the client behaves differently on a machine outside the corporate network, endpoint software is a strong candidate.
• Improve session performance. If the connection is live but sluggish, particularly on Retina displays, reduce the visual quality settings on the representative side of the session. Switching from full color to grayscale or black-and-white mode significantly reduces bandwidth load. A wired Ethernet connection, paused cloud sync, and closed video-heavy applications will all improve stability.

If the customer clicks the support link, downloads the DMG or PKG, opens it, and nothing happens, or the app icon bounces once in the Dock and vanishes, you’re dealing with a launch failure rather than a permission failure. Four things to check:

• Check macOS compatibility. The most common trigger is a version mismatch between the installed BeyondTrust build and the current macOS release. Reports of “Bomgar not working on Catalina” or “not working on Sequoia” almost always trace to an outdated client. BeyondTrust’s Supported Platforms Matrix maps software versions to compatible macOS releases, check it first.
• Get a fresh Representative Console installer. Don’t reuse an installer from your Downloads folder. Visit the BeyondTrust “Consoles and Downloads” page and download a clean copy. Stale or partially corrupted installers are a common, easily overlooked cause.
• Fully uninstall and reinstall the Customer Client. Completely remove the existing client, reboot the Mac, then run the freshly downloaded client. BeyondTrust recommends this for persistent launch issues — it eliminates conflicts from incomplete installation components.
• Follow the correct upgrade sequence. If you recently upgraded your appliance, reinstall client software afterward in the correct order. Version drift between server components and the deployed client is a reliable source of unexplained launch failures.

Jump Clients, BeyondTrust’s persistent agents for unattended remote access, must survive reboots, macOS updates, and network transitions, which creates more failure surfaces than on-demand sessions. Common causes include post-upgrade agent persistence issues, proxy detection anomalies, and console policies that mark clients offline after a set idle period.

Solutions

• Start with the Jump Client Guide Verify that the deployment method, health expectations, and offline behavior thresholds are correctly configured for your environment.
• Match the build to the appliance version If offline behavior started after a specific upgrade, check the installed build against release notes. The RS 25.1.2 release notes specifically address a proxy detection defect that caused Jump Clients to report as offline.
• Redeploy using current installation packages Packages from older appliance versions frequently cause inconsistent behavior on macOS. Use packages generated by the current appliance version, following the official deployment guide.
• Use the Error Messages reference If the console shows a specific error code, the official BeyondTrust Error Messages page maps each code to its known causes, don’t troubleshoot by guesswork.

Choosing a more reliable remote desktop solution can easily resolve the challenges of Bomgar screen sharing on macOS.

Consider HelpWire, a free remote support software for on-demand and unattended access. It offers essential features for seamless remote connections across Windows, Linux, and macOS. Designed for both personal and commercial use, HelpWire’s user-friendly interface makes setting up remote desktop sessions simple, with no complicated configurations required.

Key Highlights:

✅ Hassle-free Setup — install quickly and start remote sessions in moments.
✅ Works Across Multiple Systems — connect to Windows, macOS, and Linux devices with ease.
✅ Unattended Access — control remote machines securely, even without someone on the other end.
✅ Simple File Sharing — move files between devices with quick drag-and-drop actions.
✅ Built-in Live Chat — communicate instantly during remote sessions.

✅ Team and Client Management Tools — stay organized with features designed for streamlined collaboration.

BeyondTrust (formerly Bomgar) offers powerful remote support features, but like any software, it can come with its share of issues, particularly for Mac users.

Fortunately, the troubleshooting steps provided in this guide can help resolve the common problems and get BeyondTrust running smoothly.

However, if issues persist, exploring alternative Mac remote desktop software might be a viable option to ensure a more seamless remote experience.

Bomgar Not Working On Mac: Main Causes and Solutions

Bomgar/BeyondTrust Screen Sharing Not Working on macOS

Solution: Granting the Right Bomgar Permissions on macOS

Troubleshooting BeyondTrust Network and Connectivity Problems

BeyondTrust Remote Support Client Launch Issues on Mac

Bomgar Jump Clients Offline and Reconnection Issues on macOS

Explore Bomgar Alternative Remote Desktop Solution

Conclusion