Kantis Device Agent
About Kantis Device Agent
Section titled “About 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.
System Requirements
Section titled “System Requirements”| Requirement | Details |
|---|---|
| Operating Systems | macOS 14+, Windows 10+, Linux (Ubuntu 20.04+) |
| Memory | 512MB RAM minimum |
| Storage | 200MB available disk space |
Installation
Section titled “Installation”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
.dmgfile. The portal detects your Mac automatically; you can switch between Apple Silicon and Intel using the dropdown. - Windows: Downloads a
.exeinstaller. - Linux: Downloads a
.debpackage. 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:
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:
sudo dpkg -i Kantis-Device-Agent-amd64.debStep 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:
- Registers your device with your organization(s)
- Runs the first compliance check immediately
- Starts checking every hour in the background
Using the Device Agent
Section titled “Using the Device Agent”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.
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
Tray Icon Status
Section titled “Tray Icon Status”| 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 |
Fixing Failing Checks
Section titled “Fixing Failing Checks”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 |
Tray Menu Options
Section titled “Tray Menu Options”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
Verifying on the Portal
Section titled “Verifying on the Portal”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.
Troubleshooting
Section titled “Troubleshooting”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)
Migrating from FleetDM
Section titled “Migrating from FleetDM”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
Manual Evidence Collection
Section titled “Manual Evidence Collection”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.
Support
Section titled “Support”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.