ness-cleaner
Clean, protected agent uninstall. Before running it on Windows, create the antivirus exclusions.
Commands are run by name (the installer adds the binaries to PATH). On Windows, run them in PowerShell as administrator (recommended; required where marked "Yes"). On macOS and Linux, with sudo.
- Windows
- macOS
- Linux
Authorization modes (choose one)
| Argument | Description | Example | Requires admin |
|---|---|---|---|
--password <valor|@archivo> | Authorizes with the uninstall-protection password set in the console. With @file it reads it from a file. | ness-cleaner --password @C:\Temp\clave.txt --dry-run | Yes |
--emergency-token <token> | Single-use token generated in the console, for offline devices. | ness-cleaner --emergency-token <token> --offline | Yes |
--legacy | Allows cleanup when the organization has no uninstall password. | ness-cleaner --legacy --dry-run | Yes |
Options
| Argument | Description | Example | Requires admin |
|---|---|---|---|
--operation <all|stop|files|purge> | What to do: all (default), stop, delete files or purge. | --operation stop | Yes |
--tenant-id <uuid> | Organization ID for the audit log. | --tenant-id <uuid> | Yes |
--dry-run | Shows what would be removed without removing anything. | --dry-run | Yes |
--force, -f | Skips confirmations. | --force | Yes |
--no-reboot | Does not schedule delete-on-reboot; fails instead. | --no-reboot | Yes |
--offline | Never uses the network; stops Web Filter first. | --offline | Yes |
--quiet, -q | Minimal output. | -q | Yes |
--no-elevate | Does not auto-elevate (UAC). | --no-elevate | Yes |
The three authorization modes
- Password (
--password): when the organization enabled uninstall protection in the console. - Emergency token (
--emergency-token): single-use, generated by the administrator in the console; useful for offline devices or when the password is unknown. - Legacy (
--legacy): only works if the organization has no uninstall password.
Run with --dry-run first to see what will be removed.
--force
--force removes without asking for confirmation. Use it only after reviewing the --dry-run output.
| Argument | Description | Example | Requires admin |
|---|---|---|---|
--audit | Description pending. | sudo ness-cleaner --audit | Yes (sudo) |
--purge | Description pending. | sudo ness-cleaner --purge | Yes (sudo) |
--wipe | Description pending. | sudo ness-cleaner --wipe | Yes (sudo) |
--version | Shows the version. | ness-cleaner --version | Yes (sudo) |
Pending
Linux arguments: pending (--help output to be confirmed).
Source
Agent binaries help (--help) on Windows, macOS and Linux; NESS confirmations (Oct-2026).