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
| Area | Content | Refresh |
|---|---|---|
| System | CPU, RAM, disk, load, uptime, IP, logged-in users | every heartbeat |
| Device | Model (e.g. "Mac mini", Mac14,3), chip (Apple M2 / Intel), architecture, serial number, device type | hourly |
| macOS | Version (e.g. 15.1.1), build (e.g. 24B91), Darwin kernel | every heartbeat |
| Security | FileVault, System Integrity Protection (SIP), Gatekeeper, firewall + stealth mode, XProtect version, automatic updates, MDM enrollment | hourly |
| macOS updates | softwareupdate -l: title, version, size, kind, restart required, security update | hourly |
| Homebrew | outdated formulae and casks (brew outdated) | every 6 hours |
| Applications | apps from system_profiler (name, version, source) | every 6 hours |
| Services | third-party launchd services (without com.apple.*): label, PID, last exit code | every heartbeat |
| Disks, network, ports | volumes, interfaces, open ports | every heartbeat |
| Battery (laptops only) | charge, cycle count, maximum capacity, condition | hourly |
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 type | Models |
|---|---|
| Laptop | MacBook, MacBook Air, MacBook Pro |
| Desktop | iMac |
| Server | Mac 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)
- In the macOS module click Add Mac, enter name and customer.
- Run the displayed command in Terminal on the Mac (administrator password required):
curl -fsSL https://control.yourdomain.com/agent/macos-install.sh | sudo bash -s -- --token YOUR_TOKENFor 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:
sudo installer -pkg datazone-agent-macos.pkg -target /Afterwards:
- If
/Library/Application Support/DATAZONE/agent.jsonalready exists (update, reinstall), the agent restarts with that configuration. - Mass deployment: place
/Library/Application Support/DATAZONE/onboarding.confbeforehand with the linesCENTRAL_URL=...,MASTER_TOKEN=...and optionallyCUSTOMER_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
| What | Path |
|---|---|
| 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
| Column | Description |
|---|---|
| Name, Customer | as in all modules |
| Device type | Laptop / Desktop / Server |
| Model | e.g. "MacBook Pro" |
| macOS | version, build in the tooltip |
| Update | ready or User must confirm (see below), tooltip with what to do |
| Updates | number of pending macOS updates, security updates as red "sec" |
| FileVault | on / off / encrypting |
| Checks, Groups, Last seen | as 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:
| Tab | Content |
|---|---|
| Security | Each 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. |
| Updates | macOS updates with kind, restart and security notes, Homebrew packages, actions |
| Applications, Services, Hardware | read-only |
| Battery | laptops only |
| Disks, Network, Ports | as 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:
- Updates are downloaded (
softwareupdate -d). - Rapid Security Responses (RSR) and XProtect are tried directly.
- The logged-in user gets a notification "Please install updates".
- 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
| Button | Effect |
|---|---|
| Install security updates | security updates, RSR and XProtect only |
| Install all | all offered macOS updates |
| Update Homebrew | brew upgrade including casks |
| Notify user | notification to the logged-in user |
| Restart | shutdown -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):
| Check | Result |
|---|---|
| FileVault off | critical |
| SIP off | critical |
| Firewall off | warning |
| Gatekeeper off | warning |
| macOS security update pending for more than 14 days | warning |
| Battery: service recommended | warning |
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,~/Documentsand~/Downloadsmay 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 themacos.shellpermission and the customer binding. Every session is recorded in the audit log (actionshell_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 ID2Z7R8GDLT7). 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
| Problem | What to do |
|---|---|
| Mac does not appear | Check the log: tail -50 /Library/Logs/DATAZONE/agent.log |
| Restart the agent | sudo launchctl kickstart -k system/de.datazone.agent |
| Service status | sudo launchctl print system/de.datazone.agent |
| Change token/URL | Edit /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 input | Check the Screen Recording and Accessibility permissions (see above) |
| Remote control: no picture | Check Screen & System Audio Recording for "DATAZONE Fernwartung"; helper log: ~/Library/Logs/DATAZONE/remote-helper.log |
| Remote control: helper not running | Search 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 |