Updates and uninstalling
The Oneleet Agent updates itself. There’s nothing to install after the first time.
Updates
Section titled “Updates”The agent checks for an update every hour and installs it in the background. In the agent, Update available next to the version means an update is waiting. Click it to install the update now.
In the dashboard, a device’s Agent field shows Outdated when its agent is behind. Keep the device online with the agent connected, and it updates on its own.
An agent older than version 2.2.0 can’t update itself. Install the current version over it.
Uninstall the agent
Section titled “Uninstall the agent”Uninstalling stops the agent from reporting, but the device stays in your workspace. If the device is leaving the company, ask an admin to delete it too.
On a Mac enrolled in Oneleet MDM, an admin can remove it from MDM with Also uninstall the Oneleet Agent ticked.
On any other Mac, quit the agent from its menu bar icon, then run:
sudo launchctl bootout system/oneleet-daemonsudo rm -f /Library/LaunchDaemons/oneleet-daemon.plistsudo rm -rf /Applications/Oneleet.app "/Library/Application Support/Oneleet Agent" /var/lib/oneleet /var/log/oneleet /opt/Oneleetsudo rm -f /var/log/oneleet-daemon.out.log /var/log/oneleet-daemon.err.log /var/run/oneleet-daemon.sockMoving the app to the Trash alone leaves the background service and its files behind.
- Open Settings > Apps > Installed apps.
- Next to Oneleet, click the three dots and select Uninstall.
If you installed the .deb package, on Ubuntu, Debian, or Mint:
sudo apt remove oneleetIf you installed the .rpm package, on Fedora or RHEL:
sudo dnf remove oneleetIf you installed the agent with the install script, no package manager tracks it. Quit the agent, then run:
sudo /opt/Oneleet/oneleet-daemon uninstall[ -f /etc/apparmor.d/oneleet-agent ] && sudo apparmor_parser --remove /etc/apparmor.d/oneleet-agentsudo rm -rf /opt/Oneleet /etc/oneleet /var/lib/oneleet /var/log/oneleet /var/opt/Oneleet /etc/apparmor.d/oneleet-agentsudo rm -f /usr/bin/oneleet-agent /usr/bin/oneleet-cli /usr/share/applications/oneleet-agent.desktopUninstall with your MDM
Section titled “Uninstall with your MDM”To remove the agent from Macs with your own MDM, such as Jamf, Kandji or Mosyle, have it run this script as root. The script stops the agent, then removes the app, its background jobs, its installer receipts and its saved data. It exits with a non-zero code and names what’s left if launchd still runs the agent’s service, or if the app, one of its launchd jobs, its saved login or its data is still there afterwards, so your MDM reports the device as failed and can run it again.
#!/bin/bashAPP="/Applications/Oneleet.app"DAEMON="$APP/Contents/Resources/oneleet-daemon"
# Stop and unregister the background serviceif [ -x "$DAEMON" ]; then "$DAEMON" stop "$DAEMON" uninstallfilaunchctl bootout system/oneleet-daemon 2>/dev/null
# Quit the app and anything else still running from itpkill -f "$APP/" 2>/dev/nullsleep 2
# Keep the files while launchd still has the service, so a rerun can stop itif launchctl print system/oneleet-daemon >/dev/null 2>&1; then echo "Couldn't unload system/oneleet-daemon" >&2 exit 1fi
# Remove the jobs left by agent updates# A job that's still loaded keeps its plist, so a rerun can unload itfor plist in /Library/LaunchDaemons/com.oneleet.updater.*.plist /Library/LaunchDaemons/com.oneleet.uninstaller.*.plist; do [ -e "$plist" ] || continue job="system/$(basename "$plist" .plist)" launchctl bootout "$job" 2>/dev/null launchctl print "$job" >/dev/null 2>&1 || rm -f "$plist"done
# Remove the app, its launchd job, installer receipts and saved datarm -f /Library/LaunchDaemons/oneleet-daemon.plistrm -rf "$APP"for pkg in $(pkgutil --pkgs='com\.oneleet\..*' 2>/dev/null); do pkgutil --forget "$pkg"donerm -rf "/Library/Application Support/Oneleet Agent" /var/lib/oneleet /var/log/oneleet /opt/Oneleet \ /var/run/oneleet /var/run/oneleet-daemon.sock /var/log/oneleet-daemon.out.log /var/log/oneleet-daemon.err.log
# Fail if the app, a launchd job, the saved login or the agent's data is still therestatus=0for path in "$APP" /Library/LaunchDaemons/oneleet-daemon.plist \ /Library/LaunchDaemons/com.oneleet.updater.*.plist /Library/LaunchDaemons/com.oneleet.uninstaller.*.plist \ "/Library/Application Support/Oneleet Agent" /var/lib/oneleet /var/log/oneleet; do if [ -e "$path" ]; then echo "Couldn't remove $path" >&2 status=1 fidoneexit $statusYou can run the script again after a partial uninstall. It removes whatever is left, and exits successfully once nothing is.
Uninstalling the agent doesn’t remove the device from Oneleet. Delete it from Devices afterwards, as described in Stop monitoring a device. If the Mac is enrolled in Oneleet MDM, remove it from MDM first, which can also uninstall the agent, then delete it.