Additional setup steps required for RealVNC Server on macOS

Follow

Starting with macOS Mojave (10.14) and macOS Catalina (10.15), you must give the Screen Recording and Accessibility permissions to RealVNC Connect. If you do not grant these permissions you will see a blank screen in RealVNC Viewer and/or have view-only access.

Please follow the steps below to set up RealVNC Server for macOS correctly. These steps must be done locally on the remote computer itself, they cannot be done remotely or via the command line.

Device Access

Screen Recording (fixes black screen)

macOS Ventura (13) and later

  1. Open System Settings:
     System_Preferences.png
  2. Click Privacy & Security:
     Privacy_and_Security.png
  3. Click Screen Recording:
     Screen_Recording.png
  4. Click the lock button to make changes, and then enter an administrator's username and password:
    2.png
     Lock.png
  5. If vncagent is listed, enable it and then click the lock icon again:
     Slide.png
    Skip Step 6.
  6. Otherwise, you will need to connect to RealVNC Server from RealVNC Viewer. Once you have connected, vncagent will appear in the list. Once vncagent is listed, go back to Step 5.

macOS Monterey (12) and earlier

  1. Open System Preferences:
    Screenshot_2019-10-08_at_03.56.32.png
  2. Click Security & Privacy:
    Screenshot_2019-10-08_at_03.56.42.png
  3. Click Privacy:
    Screenshot_2019-10-08_at_03.35.11.png
  4. Click Screen Recording:
    5.png
  5. Click the lock button to make changes, and then enter an administrator's username and password:
    2.png
    Screenshot_2019-10-08_at_03.32.03.png
  6. If vncagent is listed, place a check/tick next to it, and then click the lock icon again:
    mceclip0.png
    Skip Step 7.
  7. Otherwise, you will need to connect to RealVNC Server from RealVNC Viewer. Once you have connected, vncagent will appear in the list. Once vncagent is listed, go back to Step 6.

Accessibility (fixes view-only)

macOS Ventura (13) and later

  1. Open System Settings:
     System_Preferences.png
  2. Click Privacy & Security:
     Privacy_and_Security.png
  3. Click Accessibility:
      Accessibility.png
  4. Click the lock button to make changes, and then enter an administrator's username and password:
    2.png
     Lock.png
  5. If vncagent is listed, enable it and then click the lock icon again:
     Slide.png
    Skip Step 6.
  6. Otherwise, click the + button:
     Plus_Button.png
    then navigate to /Library/vnc/vncagent and select the Open button:
    4.png
    and then click the lock icon again.

macOS Monterey (12) and earlier

  1. Open System Preferences:
    Screenshot_2019-10-08_at_03.56.32.png
  2. Click Security & Privacy:
    Screenshot_2019-10-08_at_03.56.42.png
  3. Click Privacy:
    Screenshot_2019-10-08_at_03.35.11.png 
  4. Click Accessibility:
    1.png  
  5. Click the lock button to make changes, and then enter an administrator's username and password:
    2.png
    Screenshot_2019-10-08_at_03.32.03.png
  6. If vncagent is listed, place a check/tick next to it, and then click the lock icon again:
    mceclip0.png
    Skip Step 7.
  7. Otherwise, click the + button:
    3.png
    then navigate to /Library/vnc/vncagent and select the Open button:
    4.png
    and then click the lock icon again.

On-Demand Assist

App is downloaded from the internet

You must specifically allow On-Demand Assist to be opened on install as it is downloaded from the internet. 

Mac_Download.png 

Click Open to allow the application to run.

App cannot be opened because Apple cannot check it for malicious software

The below message will appear if you are using a custom branded version of On-Demand Assist.

Mac_Branding.png 

To launch a branded version of On-Demand Assist, you need to follow the below steps.

  1. Click Show in Finder:
    macos_is_1_-_Copy.png
  2. Locate the On-Demand Assist app you downloaded in the list of files:
    Mac_Download2.png
  3. Right-click (or Control-click) the app icon, then click Open on the menu:
    Open_Mac.png
  4. Click Open:
    Open_Mac2.png
  5. The app is saved as an exception to your security settings, and you can open it at any time by double-clicking it, just as you do with any registered app.

Screen Recording (fixes black screen)

macOS Ventura (13) and later

Your end users may see a prompt similar to the below when opening On-Demand Assist. 

Mac_Screen_Recording.png

The end user will need to grant this permission so that you can view their screen.

  1. Open System Settings:
     System_Preferences.png
  2. Click Privacy & Security:
     Privacy_and_Security.png
  3. Click Screen Recording:
     Screen_Recording.png
  4. Click the lock button to make changes, and then enter an administrator's username and password:
    2.png 
     Lock.png
  5. If On-Demand Assist is listed, place a check/tick next to it, and then click the lock icon again:
     ODA.png
    Skip Step 6.
  6. Otherwise, you will need to connect to the end user using On-Demand Assist from RealVNC Viewer. Once you have connected, On-Demand Assist will appear in the list. Once On-Demand Assist is listed, go back to Step 6.

macOS Monterey (12) and earlier

Your end users may see a prompt similar to the below when opening On-Demand Assist. 

Mac_Screen_Recording.png

The end user will need to grant this permission so that you can view their screen.

  1. Open System Preferences:
    Screenshot_2019-10-08_at_03.56.32.png
  2. Click Security & Privacy:
    Screenshot_2019-10-08_at_03.56.42.png
  3. Click Privacy:
    Screenshot_2019-10-08_at_03.35.11.png 
  4. Click Screen Recording:
    5.png
  5. Click the lock button to make changes, and then enter an administrator's username and password:
    2.png 
    Screenshot_2019-10-08_at_03.32.03.png
  6. If On-Demand Assist is listed, place a check/tick next to it, and then click the lock icon again:
     ODA.png
    Skip Step 7.
  7. Otherwise, you will need to connect to the end user using On-Demand Assist from RealVNC Viewer. Once you have connected, On-Demand Assist will appear in the list. Once On-Demand Assist is listed, go back to Step 6.

Accessibility (fixes view-only)

macOS Ventura (13) and later

Your end users may see a prompt similar to the below when opening On-Demand Assist. 

ODA2.png 

The end user will need to grant this permission so that you can control their screen.

  1. Open System Settings:
     System_Preferences.png
  2. Click Privacy & Security:
     Privacy_and_Security.png
  3. Click Accessibility:
     Accessibility.png
  4. Click the lock button to make changes, and then enter an administrator's username and password:
    2.png
     Lock.png
  5. If On-Demand Assist is listed, place a check/tick next to it, and then click the lock icon again:
    ODA.png 
    Skip Step 6.
  6. Otherwise, click the + button:
     Plus_Button.png
    then navigate to the location where the On-Demand Assist app was downloaded (typically Downloads) and select the Open button:
    Mac_Download3.png
    and then click the lock icon again.

macOS Monterey (12) and earlier

Your end users may see a prompt similar to the below when opening On-Demand Assist. 

ODA2.png 

The end user will need to grant this permission so that you can control their screen.

  1. Open System Preferences:
    Screenshot_2019-10-08_at_03.56.32.png
  2. Click Security & Privacy:
    Screenshot_2019-10-08_at_03.56.42.png
  3. Click Privacy:
    Screenshot_2019-10-08_at_03.35.11.png 
  4. Click Accessibility:
    1.png
  5. Click the lock button to make changes, and then enter an administrator's username and password:
    2.png
    Screenshot_2019-10-08_at_03.32.03.png
  6. If On-Demand Assist is listed, place a check/tick next to it, and then click the lock icon again:
    ODA.png 
    Skip Step 7.
  7. Otherwise, click the + button:
    3.png
    then navigate to the location where the On-Demand Assist app was downloaded (typically Downloads) and select the Open button:
    Mac_Download3.png
    and then click the lock icon again.
Was this article helpful?
66 out of 109 found this helpful

Comments

0 comments

Article is closed for comments.