diff --git a/docs/install_agent.md b/docs/install_agent.md index a18ca17e..4187d802 100644 --- a/docs/install_agent.md +++ b/docs/install_agent.md @@ -231,18 +231,40 @@ chmod +x rmm.sh ## Mac Agent Permissions -Because Mac has no automated access to permissions you must grant all permissions manually after agent install (you might need to attempt a mesh connection once after install to get mesh to appear in the security settings) +Step 1: Open System Preferences +Click on the Apple logo in the top-left corner of your screen. +Select System Preferences from the dropdown menu. + +Step 2: Navigate to Security & Privacy +In the System Preferences window, click on Security & Privacy. +At the top of the Security & Privacy window, click the Privacy tab. ![](images/2024-02-15-22-22-56.png) -Take Control needs Screen Recording (to see anything more than the menu bar) +Step 3: Grant Accessibility Permissions +In the list on the left, scroll down and select Accessibility. +If the padlock in the bottom-left corner is locked, click it and enter your password to make changes. +Click the plus (+) button under the list on the right side. +Navigate to and select Meshcentral in the /usr/local/mesh_services/meshagent/ folder. +Ensure both are checked in the list to grant them Accessibility Permissions. -![](images/2024-02-15-22-23-48.png) +![](images/2024-02-15-22-22-33.png) -and Accessibility for keyboard/mouse input +Step 4: Grant Screen Recording Permissions +In the list on the left, find and select Screen Recording. +Unlock the padlock if necessary as described above. +Click the plus (+) button and add Meshcentral from the /usr/local/mesh_services/meshagent/ folder, or check the boxes next to them if they're already listed. +A prompt may appear asking you to quit Meshcentral. Please do so to enable the permissions. -![](images/2024-02-15-22-22-33.png) +![](images/2024-02-15-22-23-48.png) -tacticalagent needs full disk access for script running +Step 5: Grant Full Disk Access +In the list on the left, scroll down and select Full Disk Access. +Unlock the padlock if necessary as described above. +Click the plus (+) button and add Tactical RMM from the /usr/local/bin/ folder and Meshcentral from the /usr/local/mesh_services/meshagent/ folder, or check the boxes next to them if they're already listed. ![](images/2024-02-15-22-17-49.png) + +Finalizing the Setup +Restart Your Applications: Quit and restart Tactical RMM and Meshcentral for the changes to take effect. +Restart Your Mac: If the applications do not recognize the new permissions, a system restart may be necessary.