Overview
When the Drata Agent is deployed via administrative or Mobile Device Management (MDM) tools, application files and directories may inherit restricted system-level permissions. If the active local user lacks Read and Write (RW) access, the agent cannot write logs, update local state files, or replace binary packages during updates.
Symptoms
Repeated Update Alerts: The Drata Agent attempts an automatic update every hour, fails, and generates repeated failure notifications.
Launch Failures / Crashes: The application crashes immediately upon opening, often presenting generic JavaScript error popups or macOS
OSStatusexecution errors.
Prerequisites & Critical File Paths
The user running the Drata Agent must have Read and Write (RW) access to the application bundle/installation directory and its active data files:
Platform | Component | Default Path | Required Access |
macOS | Application Bundle |
| Read & Write (Recursive) |
macOS | Application Data |
| Read & Write |
Windows | Installation Folder |
| Read & Write / Modify |
Windows | Application Data |
| Read & Write / Modify |
(Refer to internal documentation: Agent File Locations for custom deployment paths.)
Diagnostic Steps: Confirming Permissions
macOS
Auto-update failures frequently occur when permissions on the top-level application wrapper differ from the internal package contents.
Method 1: GUI Inspection
Open Finder and navigate to the Applications folder.
Right-click Drata Agent.app and select Get Info (
Cmd + I). Expand the Sharing & Permissions section at the bottom to check current user permissions.Right-click Drata Agent.app and select Show Package Contents.
Highlight the Contents folder and press
Cmd + I.Verify whether the
Contentsfolder matches the top-level app permissions. If the internal package has restricted access (e.g., Read Only), auto-updates will fail.
Method 2: Terminal Inspection
Run the following commands in Terminal to compare wrapper and inner bundle permissions:
Bash
ls -ld /Applications/Drata\ Agent.app ls -l /Applications/Drata\ Agent.app
Expected Output: Both the application directory and the Contents folder should display read, write, and execute permissions (drwxr-xr-x or drwxrwxr-x) assigned to the active user or their primary administrative group.
Resolution Procedures
macOS Resolution
If permissions are misaligned or read-only, cascade ownership and write permissions across the entire package bundle.
Step 1: Set Base Permissions via GUI
In Finder, go to
/Applications.Select Drata Agent.app and press
Cmd + I.Unlock the yellow padlock in the bottom right corner with an administrator password.
Set the logged-in user to Read & Write.
Step 2: Propagate Recursively via Terminal
To apply these permissions through all nested subdirectories and binaries:
Open Terminal.
Run the following command to cascade the base bundle’s octal permissions recursively:
Bash
sudo chmod -R `stat -f '%A' /Applications/Drata\ Agent.app` /Applications/Drata\ Agent.app
Run the following command to cascade ownership recursively:
Bash
sudo chown -R `stat -f '%Su:%Sg' /Applications/Drata\ Agent.app` /Applications/Drata\ Agent.app
Restart the Drata Agent.
Note for MDM Administrators: If your MDM solution or endpoint manager runs periodic enforcement policies, package reinstalls or compliance scripts may reset these permissions. Ensure your deployment script explicitly provisions the /Applications/Drata Agent.app folder with the target user as owner.
Windows Resolution
Ensure the active Windows user account has full Modify rights to both the executable directory and the working data files.
Step 1: Update Application Data Files (app-data.json & main.log)
Press
Win + R, paste%AppData%\drata-agent, and hit Enter.Right-click
app-data.jsonand select Properties.Select the Security tab and click Edit.
Select the current user account and check the Allow box for Modify (ensuring Read, Write, and Read & execute are also enabled).
Click Apply, then OK.
Repeat steps 2–5 for
main.log.
Step 2: Update Application Installation Folder
Press
Win + R, paste%LocalAppData%\Programs, and hit Enter.Locate the
drata-agentfolder.Right-click the
drata-agentfolder and select Properties.Go to the Security tab and select Edit.
Select the logged-in user account, check Allow for Modify, and apply changes.
Relaunch the Drata Agent.
