Skip to content

Kantis Device Agent

Kantis Device Agent is a lightweight desktop application that runs in your system tray and automatically monitors your device’s security compliance. It checks your device configuration every hour and reports the results to your organization’s Kantis portal.

The agent checks four security areas:

Security Check What It Verifies
Disk Encryption FileVault (macOS), BitLocker (Windows), or LUKS (Linux) is enabled
Malware Protection Active, healthy malware protection (XProtect, Windows Defender, ClamAV, or supported EDR)
Password Policy Minimum 8-character password enforced at the OS level
Screen Lock Automatic screen lock activates within 5 minutes of inactivity

Your device is compliant when all four checks pass.

Requirement Details
Operating Systems macOS 14+, Windows 10+, Linux (Ubuntu 20.04+)
Memory 512MB RAM minimum
Storage 200MB available disk space
Step 1: Download the Agent

Log in to your organization’s Employee Portal and open the Download and install Kantis Device Agent task. Click Download Agent to get the installer for your operating system.

  • macOS: Downloads a .dmg file. The portal detects your Mac automatically; you can switch between Apple Silicon and Intel using the dropdown.
  • Windows: Downloads a .exe installer.
  • Linux: Downloads a .deb package. Use the dropdown to switch between x86-64 and ARM64.
Step 2: Install the Agent

macOS: Double-click the downloaded .dmg file and drag the Kantis Device Agent to your Applications folder. Then open Terminal and run these two commands:

Terminal window
xattr -cr "/Applications/Kantis Device Agent.app"
open "/Applications/Kantis Device Agent.app"

Windows: Double-click the downloaded .exe file and follow the installation wizard.

Linux: Install the downloaded .deb package using your package manager or by double-clicking it:

Terminal window
sudo dpkg -i Kantis-Device-Agent-amd64.deb
Step 3: Sign In

After installation, the agent opens a sign-in window. Log in with your work email using the same method you use for the Employee Portal (email OTP, Google, or Microsoft), select your organization, and click Link Device.

Once linked, the agent automatically:

  1. Registers your device with your organization(s)
  2. Runs the first compliance check immediately
  3. Starts checking every hour in the background

After signing in, the agent lives in your system tray (menu bar on macOS, system tray on Windows/Linux). Click the tray icon to open the status window.

Device Agent Status Window

The status window shows:

  • Compliance status — whether your device is compliant or needs attention
  • Individual checks — each of the four security checks with Pass/Fail status
  • Remediation options — for any failing check, the agent offers a way to fix it
Icon Color Meaning
Green Device is compliant — all checks passing
Red Device is non-compliant — one or more checks failing
Gray Agent is not signed in or checks are loading

When a check fails, the agent provides remediation options depending on what can be done automatically:

Option Description
Fix The agent fixes the issue automatically
Fix (Admin) The agent fixes it but may prompt for your system password
Open Settings Opens the relevant OS settings pane so you can fix it manually
View Guide Shows step-by-step instructions to resolve the issue

Right-click (or click on macOS) the tray icon to access:

  • Run Checks Now — trigger an immediate compliance check
  • View Details — open the status window
  • Start at Login — toggle whether the agent launches automatically when you log in (enabled by default)
  • Sign Out — sign out of the agent
  • Quit — close the agent completely

After the agent runs its first check, you can verify your device compliance status on the Employee Portal. The Device Agent task shows your device name, platform, and whether all security checks are passing.

The portal updates automatically — it polls your device status every 30 seconds while the page is open.

macOS says the app is "damaged" or refuses to open it
  • The app is not yet signed with an Apple certificate, so macOS quarantines it after download
  • Open Terminal and run xattr -cr "/Applications/Kantis Device Agent.app", then open the app again
Agent won't sign in
  • Make sure you’re using the same email address you use for the Employee Portal
  • Check your internet connection
  • Try quitting the agent completely and reopening it
  • If using Google or Microsoft sign-in, make sure popups are not blocked
Checks are failing unexpectedly
  • Click Run Checks Now to refresh the results - Review the failing check details — the agent shows what it detected - Use the remediation option provided (Fix, Open Settings, or View Guide) - Some changes (like enabling FileVault) require a restart to take effect
Agent is not visible in the system tray
  • macOS: Look in the menu bar at the top of your screen. The icon may be hidden — check the overflow area (click the >> or similar)
  • Windows: Click the up arrow in the system tray to see hidden icons
  • Linux: Check your desktop environment’s system tray or notification area
  • The agent may need to be reopened from your Applications folder
Portal shows device as non-compliant even though agent shows all checks passing
  • Wait up to 30 seconds for the portal to refresh
  • Click Run Checks Now in the agent to trigger a fresh report
  • Check that the agent is signed in (tray icon should be green, not gray)

If your device previously had the FleetDM agent (fleetd) installed, you should uninstall it after setting up the new Kantis Device Agent. The new agent fully replaces FleetDM, and having both running is unnecessary.

Follow the official uninstall guide for your platform: How to uninstall fleetd

If your company asks for screenshots instead of the Device Agent, follow Device Screenshots: it shows, for Windows, macOS and Linux, how to turn on each required setting and what each screenshot must show. You upload them in the employee portal, where an admin at your company reviews them.

The canonical Device Agent requirements and troubleshooting guide is available at app.getkantis.com/docs/device-agent.

If you have questions or run into issues with the Device Agent, contact your IT administrator or reach out to us at support@getkantis.com.