Skip to content

macOS ​

The macOS module (since v3.22.0) manages Macs: MacBook, iMac, Mac mini, Mac Studio and Mac Pro, with Intel or Apple Silicon. It shows state, security and updates, distributes macOS and Homebrew updates through jobs, runs scripts and checks, and offers shell, tunnels and RustDesk remote access.

The module color is gray (slate). It only appears as an accent (icon, dot in the sidebar).

What is collected ​

AreaContentRefresh
SystemCPU, RAM, disk, load, uptime, IP, logged-in usersevery heartbeat
DeviceModel (e.g. "Mac mini", Mac14,3), chip (Apple M2 / Intel), architecture, serial number, device typehourly
macOSVersion (e.g. 15.1.1), build (e.g. 24B91), Darwin kernelevery heartbeat
SecurityFileVault, System Integrity Protection (SIP), Gatekeeper, firewall + stealth mode, XProtect version, automatic updates, MDM enrollmenthourly
macOS updatessoftwareupdate -l: title, version, size, kind, restart required, security updatehourly
Homebrewoutdated formulae and casks (brew outdated)every 6 hours
Applicationsapps from system_profiler (name, version, source)every 6 hours
Servicesthird-party launchd services (without com.apple.*): label, PID, last exit codeevery heartbeat
Disks, network, portsvolumes, interfaces, open portsevery heartbeat
Battery (laptops only)charge, cycle count, maximum capacity, conditionhourly

Slow sources run in the agent's background cache. The heartbeat never waits for them. Rescan (detail panel or context menu) clears the cache and reads again immediately.

Device type ​

The agent derives the device type from the model:

Device typeModels
LaptopMacBook, MacBook Air, MacBook Pro
DesktopiMac
ServerMac mini, Mac Studio, Mac Pro, Xserve

A Mac mini used as a workstation can be switched manually in the detail panel under Overview > Device type. The device type controls:

  • the offline alert, for servers only. Switched-off laptops and iMacs are not a problem (like Windows workstations).
  • the device type filter in jobs (Servers only / Workstations only) and in the list.

Installation ​

Via curl (single Mac) ​

  1. In the macOS module click Add Mac, enter name and customer.
  2. Run the displayed command in Terminal on the Mac (administrator password required):
bash
curl -fsSL https://control.yourdomain.com/agent/macos-install.sh | sudo bash -s -- --token YOUR_TOKEN

For self-registration with the master token, the command is under Settings > Onboarding > macOS.

The installer downloads the matching binary (datazone-agent-darwin-arm64 or -amd64). It is signed by DATAZONE and notarized by Apple, Gatekeeper does not block it.

Via package (.pkg) ​

Alternatively there is the signed and notarized package datazone-agent-macos.pkg (universal binary for Intel and Apple Silicon). It installs the agent and the launchd service but contains no customer data:

bash
sudo installer -pkg datazone-agent-macos.pkg -target /

Afterwards:

  • If /Library/Application Support/DATAZONE/agent.json already exists (update, reinstall), the agent restarts with that configuration.
  • Mass deployment: place /Library/Application Support/DATAZONE/onboarding.conf beforehand with the lines CENTRAL_URL=..., MASTER_TOKEN=... and optionally CUSTOMER_NUMBER=.... The Mac registers itself, the file is deleted afterwards.
  • Otherwise the agent is installed but not started. Register it with the curl installer from Settings > Onboarding.

Installation paths ​

WhatPath
Binary/usr/local/datazone/datazone-agent
Configuration/Library/Application Support/DATAZONE/agent.json (readable by root only)
Log/Library/Logs/DATAZONE/agent.log
launchd service/Library/LaunchDaemons/de.datazone.agent.plist (label de.datazone.agent)
Remote control helper/Library/Application Support/DATAZONE/DATAZONE Fernwartung.app, LaunchAgent /Library/LaunchAgents/de.datazone.agent.remote.plist (installed by the agent)

List ​

ColumnDescription
Name, Customeras in all modules
Device typeLaptop / Desktop / Server
Modele.g. "MacBook Pro"
macOSversion, build in the tooltip
Updateready or User must confirm (see below), tooltip with what to do
Updatesnumber of pending macOS updates, security updates as red "sec"
FileVaulton / off / encrypting
Checks, Groups, Last seenas in all modules

More columns (chip, user, serial number, CPU/RAM/disk, status as a word, remote) can be shown via the column menu. The device type filter, status filter (including maintenance / out of service), saved views and bulk actions work as in the other modules. Bulk actions: update, update + restart, Update Homebrew, restart, agent update, maintenance / out of service, script, check.

Detail panel ​

Overview shows load, macOS version, updates, security and device type as tiles, below that model, chip, macOS + build, serial number, device type, logged-in user and uptime. Sub-tabs:

TabContent
SecurityEach feature as dot + word with one sentence "what to do" (e.g. FileVault off: turn it on in System Settings and store the recovery key safely). Below that automatic updates and Wazuh.
UpdatesmacOS updates with kind, restart and security notes, Homebrew packages, actions
Applications, Services, Hardwareread-only
Batterylaptops only
Disks, Network, Portsas for Linux

Plus the tabs Updates, Checks, Jobs, Shell, Log, Groups and Agent as in the other modules.

Updates ​

Apple Silicon: the honest limit without MDM ​

On Macs with Apple Silicon, a program cannot install macOS updates without a user: Apple requires the approval of a user with a secure token (or an MDM). Control therefore does what is possible:

  1. Updates are downloaded (softwareupdate -d).
  2. Rapid Security Responses (RSR) and XProtect are tried directly.
  3. The logged-in user gets a notification "Please install updates".
  4. The task ends as completed with the result "downloaded, user must confirm", not as a failure.

The Update column then shows User must confirm. Plain text: "Apple Silicon: macOS updates need the approval of a user at the Mac. Control downloads them and shows the user a notice." Notify user sends the notice again at any time.

Intel Macs install without a user (softwareupdate -i). A restart only happens if Allow restart is set and an update needs it.

Actions in the Updates tab ​

ButtonEffect
Install security updatessecurity updates, RSR and XProtect only
Install allall offered macOS updates
Update Homebrewbrew upgrade including casks
Notify usernotification to the logged-in user
Restartshutdown -r +1 (warning if a user is logged in)

Jobs ​

Under macOS > Jobs there are the update types Security updates, All macOS updates and Update Homebrew, plus script, playbook and check. Fields device type (All / Servers only / Workstations only) and Allow restart (Intel only, not for Homebrew). Hosts in maintenance or out of service are skipped. See Scheduled jobs.

Homebrew ​

Homebrew must not run as root. Control therefore runs brew upgrade as the owner of the Homebrew installation (/opt/homebrew or /usr/local). Without Homebrew the task ends with "no Homebrew", the button is then grayed out.

Checks ​

Predefined checks for macOS (zsh scripts with Nagios exit codes, distributed through check jobs):

CheckResult
FileVault offcritical
SIP offcritical
Firewall offwarning
Gatekeeper offwarning
macOS security update pending for more than 14 dayswarning
Battery: service recommendedwarning

Own scripts for macOS: language zsh, bash, sh or python (python3), module macOS. See Checks and Scripts.

Files (since v3.30.0) ​

Tab Files in the detail panel: browser file manager like on Windows and Linux (host online, permission Files or Manage files). Browse folders, download files and folders (as ZIP), upload, rename, delete, create folders.

  • The agent runs as root and can read every file. These permissions are therefore not part of the Viewer role.
  • System folders are protected against delete and rename, e.g. /System, /Applications, /Library, /Users, /private, /usr/local, plus the files of the agent and the helper (/usr/local/datazone, /Library/Application Support/DATAZONE, the LaunchDaemon/LaunchAgent plists). The protection of the Mac folders works from agent 3.30.0; older agents only protect the generic Unix folders.
  • Folders under the user's ~/Desktop, ~/Documents and ~/Downloads may appear empty or report "access denied" because of macOS privacy (TCC). In that case the agent has no Full Disk Access.

Remote access ​

  • Shell: Shell tab or context menu (permission macos.shell). The agent starts a zsh as root directly on the Mac, without login and without SSH (Remote Login does not need to be on). Who may open it is controlled only by the macos.shell permission and the customer binding. Every session is recorded in the audit log (action shell_open).
  • Tunnels: presets SSH (22), Screen Sharing/VNC (5900), SMB, HTTP(S).
  • RustDesk: as for Windows/Linux. macOS requires two permissions that only a user at the Mac can grant: allow RustDesk under System Settings > Privacy & Security > Screen Recording and > Accessibility. Without Screen Recording the picture stays black; without Accessibility mouse and keyboard do not respond.

Remote control (Take Control) ​

From version 3.26.0 a Mac's screen can be controlled directly in the browser just like Windows (button Remote control, permission macos.takecontrol; the permission is sensitive and is not granted through "all subtabs"). General flow, consent and viewer: Take Control.

  • Helper app: picture and input are handled by the signed app DATAZONE Fernwartung (/Library/Application Support/DATAZONE/DATAZONE Fernwartung.app), which runs as a LaunchAgent (de.datazone.agent.remote) inside the logged-in user. The agent downloads it by itself and keeps it at its own version (at start and before every remote session, checking the Apple signature of DATAZONE GmbH). Nothing has to be installed on the Mac.

  • One-time permissions: on the first remote session the user at the Mac must enable two entries for DATAZONE Fernwartung under System Settings > Privacy & Security:

    • Screen & System Audio Recording – without it there is no picture. Control then reports "Freigabe 'Bildschirmaufnahme' fehlt …" (screen recording permission missing).
    • Accessibility – without it you can only watch, mouse and keyboard have no effect.

    From 3.31.1 a window Freigaben für die Fernwartung (permissions for remote support, with the DATAZONE logo) guides the user through both steps: it shows live which permission is missing and opens the right page of System Settings with Freigeben … (grant). There the user switches on DATAZONE Fernwartung and confirms "Quit & Reopen" for Screen Recording. The helper restarts by itself, and the window shows the next step or "Alles erledigt" (all done). The window appears once after installation (if a permission is missing) and on every remote session that lacks a permission. If Screen Recording was missing, simply reconnect after granting it. If only Accessibility was missing, mouse and keyboard work right after granting it, without reconnecting. It cannot be done without a user at the Mac; macOS does not allow that.

    After that remote control works unattended (with banner or prompt depending on the setting). The permissions survive updates of the helper app.

  • MDM: Accessibility can be pre-approved with a PPPC profile (Privacy Preferences Policy Control; bundle ID de.datazone.agent.remote, team ID 2Z7R8GDLT7). Apple does not allow MDM to grant Screen Recording silently – at most a standard user may be allowed to enable it themselves.

  • Logged-in user only: the login window (nobody logged in, after a reboot) is not supported in this version. Control then reports "Kein Benutzer am Mac angemeldet oder Hilfsprogramm läuft nicht" (no user logged in or helper not running). With fast user switching the user currently on screen is controlled.

  • There is no Ctrl+Alt+Del on a Mac; the Windows key maps to Command, Alt maps to Option.

  • Ask the user (from 3.48.1): until the user has agreed, the agent forwards no mouse, keyboard or clipboard input to the Mac and no picture leaves the Mac. Control messages from the viewer to the helper are always dropped by the agent. The same applies to Linux desktops.

Troubleshooting ​

ProblemWhat to do
Mac does not appearCheck the log: tail -50 /Library/Logs/DATAZONE/agent.log
Restart the agentsudo launchctl kickstart -k system/de.datazone.agent
Service statussudo launchctl print system/de.datazone.agent
Change token/URLEdit /Library/Application Support/DATAZONE/agent.json, then restart the agent
Update stays at "User must confirm"Expected on Apple Silicon without MDM: the user must confirm in System Settings > Software Update
RustDesk black / no inputCheck the Screen Recording and Accessibility permissions (see above)
Remote control: no pictureCheck Screen & System Audio Recording for "DATAZONE Fernwartung"; helper log: ~/Library/Logs/DATAZONE/remote-helper.log
Remote control: helper not runningSearch the agent log for remote helper; status: launchctl print gui/$(id -u)/de.datazone.agent.remote (as the logged-in user)
Security values "unknown"Update the agent to 3.22.0 or newer, start a rescan

DATAZONE Control Documentation