Skip to main content

Installing ComplyJet Agent ( MacOS)

A complete step-by-step guide to installing, enrolling, verifying, troubleshooting, and managing the ComplyJet Agent on your Mac.

Written by Upendra Varma
Updated over 2 weeks ago

The ComplyJet Agent is a lightweight tray application that runs in the background on your macOS device. It performs read-only compliance checks (such as encryption, antivirus, and screen lock settings) and securely reports the results to your organization’s ComplyJet dashboard.

The agent:

  • Runs quietly in the menu bar

  • Syncs automatically every 24 hours

  • Auto-updates in the background

  • Starts automatically when your Mac restarts

  • Does not access your files or personal content

Step 1 – Start from the ComplyJet Dashboard

Go to your ComplyJet Dashboard

  1. Log in to your ComplyJet account.

  2. If you are an Admin, switch to Employee View (top right).

  3. Navigate to the Devices tab in the left sidebar.

  4. Click Enroll a Device.

Step 2 – Download & Install the macOS Agent

Download the macOS Installer

Inside the Enroll modal:

  1. Click Download for macOS

  2. A .dmg file will download to your Mac (usually in Downloads folder)

Open the DMG File

  1. Go to your Downloads folder

  2. Double-click the .dmg file

  3. A window will appear with the ComplyJet app

Move to Applications

  1. Drag the ComplyJet Agent icon into the Applications folder
    (Just like installing any other Mac application)

Launch the Agent

  1. Open Applications

  2. Double-click ComplyJet Agent

  3. If macOS prompts:

    • Click Open

    • Allow required permissions if prompted

You will now see “ComplyJet Agent installed successfully” screen.


Enroll this device to start continuous compliance monitoring.

Step 3 – Enroll Your Device

Get Your Enrollment Code

  1. Go back to your browser (ComplyJet dashboard)

  2. In the Enroll modal, copy the Enrollment Code

Paste Enrollment Code

  1. Paste the code into the agent’s Enrollment Link field

  2. Click Enroll Device

If successful, you’ll see "Successfully Registered Screen"


Verify Installation

After enrollment:

You will see the device dashboard screen.

You should see:

  • Agent: Installed

  • Last Connected: Just now

  • Compliance: Compliant (or Non Compliant based on checks)

What Happens Next?

The agent will automatically start evaluating:

  • Hard Drive Encryption

  • Screen Lock

  • Anti-Virus

If any check fails:

Tray Agent Behavior

The ComplyJet Agent is a menu bar application.

You will NOT see:

  • A Dock icon

  • A visible app window running constantly

You WILL see:

  • A 🚀 Rocket icon in the top macOS menu bar

If you don’t see the icon:

  • Go to the menu bar at the top

  • Drag other icons left ( CMD click + drag )

  • Look for the ComplyJet rocket icon, as other icons are moved towards far left

Agent Menu Options Explained

Click the gear icon in the top-right of the agent window.

You’ll see:

  • ComplyJet Dashboard → Opens your dashboard

  • Download Logs → Exports diagnostic logs

  • Help → Opens support resources

  • Disconnect Device → Unenrolls this device

  • Quit Agent → Stops the agent for this session

Sync Behavior

The agent:

  • Automatically syncs every 24 hours

  • Syncs immediately when you click Sync now

  • Syncs after enrollment

You do NOT need to manually sync daily.

Auto-Start & Auto-Update

The agent:

  • Automatically starts when your Mac boots

  • Automatically installs updates

  • Requires no manual patching

If you restart your machine:

  • The agent starts automatically

  • No reinstallation needed

Uninstalling the Agent

To uninstall:

  1. Quit the agent from the menu bar

  2. Go to Applications

  3. Drag ComplyJet Agent to Trash

  4. Empty Trash

If you plan to re-enroll:

  • You can reinstall using the same steps

  • Usually the system detects it as the same device

Disconnecting the Device

To disconnect:

  1. Open the agent

  2. Click the gear icon

  3. Select Disconnect Device

This will:

  • Unenroll the device

  • Remove it from compliance reporting

You can re-enroll anytime using a new enrollment code.

Logs & Troubleshooting

Click Download Logs from the gear menu.

This generates a log file containing:

  • Sync attempts

  • Enrollment status

  • Compliance scan results

  • OS query execution logs

You can:

  • Review the file manually

  • Share it with ComplyJet Support

Security & Privacy

The ComplyJet Agent is built with a privacy-first and security-first architecture. It collects only the minimum system information required to validate device compliance.

Built on Open Source (osquery)

The ComplyJet Agent uses osquery, a widely adopted open-source system instrumentation framework.

  • Originally developed by Facebook

  • Used across enterprise security platforms

  • Fully open source and publicly auditable

osquery allows safe, SQL-style queries against system tables. The ComplyJet Agent uses it to run read-only system checks.

It does not modify system settings.
It does not monitor user behavior.
It does not inject code.

What the Agent Checks

The agent collects only compliance-related signals such as:

  • Hard drive encryption status (FileVault / BitLocker)

  • Screen lock configuration

  • Antivirus presence

  • Basic system metadata (OS version, serial number, device identifier)

It does not collect:

  • Personal files or file contents

  • Emails, documents, or photos

  • Browser history

  • Keystrokes or screen recordings

  • Personal application data

The checks are strictly limited to configuration signals.

Apple Code Signing & Notarization

The macOS agent:

  • Is signed with an Apple Developer ID certificate

  • Is fully notarized by Apple

  • Uses hardened runtime protections

macOS verifies the integrity of the application, and you should not see unidentified developer warnings.

Full Transparency

You can review exactly what the agent is doing at any time:

  1. Click the ⚙️ gear icon

  2. Select Download Logs

  3. Open the generated log file

The logs include:

  • Compliance checks executed

  • osquery results

  • Enrollment and sync events

Data Security

All data transmitted by the agent:

  • Is encrypted in transit (TLS)

  • Is limited to compliance signals only

  • Does not include personal content

Frequently Asked Questions (FAQs)

1. I installed the agent but don’t see it.

Check the top macOS menu bar for the rocket icon.

2. The device shows Non-Compliant.

Click into the Compliance tab and see which check failed. Use the relevant help article to fix it.

3. I changed a setting but status didn’t update.

Click Sync now or restart your Mac.

4. Can I disable it temporarily?

Yes. Click Quit Agent.
It will restart when you reboot.

5. Does this slow down my computer?

No. The agent is lightweight and runs minimal checks.

6. What if enrollment fails?

  • Check your internet connection

  • Re-copy the enrollment code

  • Restart the agent

  • Contact ComplyJet Support if it persists

7. What if I get a macOS security warning?

This shouldn't happen. ComplyJet agent is securely signed & notarized after a thorough validation by Apple team. Please reach out to support so that we can check this.

8. Can I install it on multiple devices?

Yes, but each device must be enrolled separately.

9. Will it update automatically?

Yes. No manual update required.

10. What happens if I disconnect?

The device will stop reporting.
You can re-enroll anytime.

Did this answer your question?