LICENSEWARE Collector

Download and Install

Linux (.deb / .rpm)

⚠️ Requires root privileges

1. Download the package for your architecture

   curl -fsSLO https://cdn.licenseware-collector.com/d/latest/licenseware-collector_amd64.deb

2. Install the package
   sudo apt install ./licenseware-collector_amd64.deb

   On RHEL / Fedora / SUSE use sudo dnf install ./licenseware-collector_amd64.rpm. Installing stages the service but does not start it — the next step does.

3. Enroll the machine and start the service

   sudo TOKEN=<enrollment-token> licenseware-collector register

export HTTPS_PROXY="http://proxy.corp.com:8080" # optional
export NO_PROXY="localhost,127.0.0.1" # optional
export CA_CERT_PATH=/etc/ssl/certs/corp-ca.pem # optional
sudo -E TOKEN=<enrollment-token> licenseware-collector register

sudo TOKEN=<enrollment-token> licenseware-collector register \
  --ca-cert /etc/ssl/certs/corp-ca.pem

macOS (.pkg)

⚠️ Requires root privileges

1. Install the package

   sudo installer -pkg LicensewareCollector.pkg -target /

2. Enroll the machine and start the service

   sudo TOKEN=<enrollment-token> \
     /usr/local/licenseware-collector/seed/licenseware-collector register

Windows

⚠️ Requires Administrator privileges

1. Download the installer

   Invoke-WebRequest -Uri https://cdn.licenseware-collector.com/d/latest/LicensewareCollector.msi `
     -OutFile LicensewareCollector.msi

2. Install, passing the enrollment token

   msiexec /i LicensewareCollector.msi TOKEN=<enrollment-token>

   The token is marked as a secure property, so it is never written to the MSI log. Run the same command with a newer .msi to upgrade in place.

Unattended / MDM deployment (Intune, SCCM)

The install runs as SYSTEM and is fully unattended: msiexec /i LicensewareCollector.msi TOKEN=<enrollment-token> /qn /norestart. Enrolment happens synchronously inside the installer — nothing is deferred to a background task.

Exit codes

These are standard Windows Installer codes. There are no vendor-specific values.

Detection rule

Use a PowerShell detection script. Do not use a file-version rule: agents released before the 2026-08 build carry no version resource at all, so the comparison can never match. A product-code rule reports success even when enrolment did not complete.

$svc = Get-Service licenseware-collector -ErrorAction SilentlyContinue
$env = "$env:ProgramData\Licenseware\collector.env"
if ($svc -and (Test-Path $env) -and (Select-String -Path $env -Pattern '^TOKEN=..*' -Quiet)) {
    Write-Output "Installed"
    exit 0
}
exit 1

The TOKEN= line is written only by a completed enrolment, and the Windows service is created only by register. Together they mean the agent is genuinely reporting in.

$env:TOKEN = "<enrollment-token>"
& "$env:ProgramFiles\Licenseware\LicensewareCollector.exe" register `
  --ca-cert <PATH> --env-file <PATH>

$env:HTTPS_PROXY = "http://proxy.corp.com:8080"
$env:NO_PROXY = "localhost,127.0.0.1"
$env:TOKEN = "<enrollment-token>"
& "$env:ProgramFiles\Licenseware\LicensewareCollector.exe" register `
  --ca-cert "C:\certs\internal-ca.pem"

Linux

1. Debian / Ubuntu
   sudo apt remove licenseware-collector
2. RHEL / Fedora / SUSE
   sudo dnf remove licenseware-collector

Removing the package stops the service and runs the uninstaller for you. Do not call licenseware-collector uninstall directly on a package-managed host — it refuses and points you back at the package manager.

macOS

Download uninstall.command from the Downloads section and double-click it, or run it from Terminal:

sudo LICENSEWARE_UNINSTALL_FROM_PACKAGE=1 \
  /usr/local/libexec/licenseware-collector/licenseware-collector uninstall --force
sudo rm -rf /usr/local/licenseware-collector
sudo pkgutil --forget io.licenseware.collector

Windows (Administrator PowerShell)

1. Uninstall the package

   msiexec /x LicensewareCollector.msi

2. Or remove it from the UI:
   Settings > Apps > Installed apps

Comprehensive system, hardware, and software inventory collection

Software usage patterns and execution history

Running processes, services, and active sessions