Setup

Add employees to your workspace (Admins only)

1. Go to the Oneleet Dashboard.
2. Click on the People tab.
3. Make sure everyone you want to add is either a workspace member or an employee.

Note

An employee has access to the Oneleet Portal, while a workspace member has access to both the Dashboard and the Portal.

Use the OS-specific instructions below to install the Oneleet Agent on your devices.

The Oneleet Agent updates automatically. The Latest or Outdated badge shows whether the installed agent version is up to date.

Note

Macs enrolled through Apple MDM may receive the Oneleet Agent package automatically. After installation, users still need to open the Oneleet Agent and complete the normal login flow before the agent can report device data.

macOS

System requirements

Minimum system requirements for the Oneleet Agent on macOS:

• macOS 13 (Ventura)
• 8 GB RAM

Download

Directly from Oneleet Portal

1. Open the Oneleet Portal in your browser and log in.
2. Click on the Devices tab to download the Oneleet Agent for macOS.

Install

The above steps should have downloaded a .pkg file to install the Oneleet Agent on your Mac.

1. Double-click on the .pkg file to install the agent.
2. You can now search for Oneleet in Launchpad to launch the Oneleet Agent, or open it directly from the Applications folder.

Homebrew

brew tap oneleet/tap
brew install --cask oneleet-agent

Uninstall

Caution

This will remove the Oneleet Agent from your device and stop all monitoring of your system state which can affect your compliance and security.

Directly from Oneleet Portal

1. Stop the background service by running sudo launchctl stop oneleet-daemon
2. Open Finder and go to the Applications folder.
3. Locate the Oneleet app bundle.
4. Drag the app to the Trash or right-click and select Move to Trash.
5. Empty the Trash by right-clicking on the Trash icon and selecting Empty Trash.

Homebrew

brew uninstall oneleet-agent

Windows

System requirements

Minimum system requirements for the Oneleet Agent on Windows:

• Windows 10 x64
• 8 GB RAM

Download

1. Open the Oneleet Portal in your browser and log in.
2. Click on the Devices tab to download the Oneleet Agent for Windows.

Install

The above step should have downloaded a setup .exe file to install the Oneleet Agent on your PC.

1. Double-click on the setup .exe file to run it.
2. Follow the on-screen instructions to install the Oneleet Agent.
3. Once installed, you can launch the Oneleet Agent by clicking on the Oneleet shortcut on your desktop, or by searching for Oneleet in your search bar or the Start menu.

Deploy with an MSI

For managed deployments, download the MSI for your agent release from https://downloads.oneleet.com/agent/windows/Oneleet-VERSION-setup.msi, replacing VERSION with the release version. Releases that predate MSI support only have an EXE installer.

Run the following from an elevated Command Prompt or a deployment tool running as SYSTEM. Replace the path and VERSION with the downloaded MSI:

msiexec.exe /i "C:\Installers\Oneleet-VERSION-setup.msi" /qn /norestart

This installs the agent for all users and starts its background service without showing an installation wizard. Users still need to open Oneleet and connect their device to the workspace after installation.

For Intune, package the MSI as a Windows app (Win32) using Microsoft’s Win32 Content Prep Tool, with System install behavior. Configure detection using oneleet-agent.exe in the installation folder, normally C:\Program Files\oneleet-agent. Accept a file version at least as new as the version you’re deploying so automatic updates continue to satisfy detection.

The MSI runs the same installer as the EXE download and doesn’t register a separate MSI product. MSI product-code detection, MSI repair, and msiexec /x aren’t supported. Uninstall through Oneleet in Windows Installed apps, or use the QuietUninstallString from Oneleet’s entry under HKLM\Software\Microsoft\Windows\CurrentVersion\Uninstall for managed removal.

Uninstall

Caution

This will remove the Oneleet Agent from your device and stop all monitoring of your system state which can affect your compliance and security.

1. Open the Control Panel and navigate to the Add or remove programs section
2. Scroll to find Oneleet.
3. Click More (three dots) next to it, then select Uninstall.

Linux

System requirements

Minimum system requirements for the Oneleet Agent on Linux:

• x86_64 or arm64
• 8 GB RAM

Download

1. Open the Oneleet Portal in your browser and log in.
2. Click on the Devices tab to download the Oneleet Agent for your Linux distribution.

Install

For DEB and RPM, install the package using the package manager. You should have /usr/bin/oneleet-agent available after installation, along with a Desktop entry.

For the install script, simply run the script as root.

Uninstall

Caution

This will remove the Oneleet Agent from your device and stop all monitoring of your system state which can affect your compliance and security.

Ubuntu, Debian, Mint

sudo apt remove oneleet

Fedora, Rocky/RHEL

sudo dnf remove oneleet