LICENSEWARE Collector Logo

LICENSEWARE Collector

What is LICENSEWARE Collector?
A free lightweight agent that collects system and software inventory data from your servers and securely transmits it to the LICENSEWARE ™ platform for software license compliance analysis.

Operating System Compatibility

Linux

  • x86_64 (64-bit) only
  • systemd required
  • RHEL, Ubuntu, Debian, etc.

Windows

  • x86_64 (64-bit) only
  • Windows 7 SP1+ (Desktop)
  • Windows Server 2012 R2+

macOS

  • Intel & Apple Silicon
  • macOS 10.15+
  • launchd service

Network Requirements

  • api.licenseware.ioHTTPS 443
    Primary API for data ingestion and configuration
  • cdn.licenseware-collector.comHTTPS 443
    Fetches static assets and updates
  • github.comHTTPS 443
    Downloads dependencies (installation only)

System Requirements

  • Architecture
    64-bit only (32-bit not supported)
  • Disk Space
    ~100 MB for binaries and temp files
  • Memory
    Minimal (~50 MB during operation)

API Endpoints

All communication uses HTTPS with Bearer token authentication.

MethodEndpointPurposeFrequency
POST/agent/registerRegister agentOnce
GET/agent/configsFetch configsEvery 30m
GET/agent/catalogsGet catalogsEvery 30m
POST/agent/ingestUpload dataCyclical

Data Collection Process

What You Do

Download
Collector
→
Register
Collector
→
✓ Done!

What the Collector Does

Fetch Query
Catalogs
→
Execute
Queries
→
Upload to
LICENSEWARE ™

Data Collection Catalogs

System Inventory

Every 24 hours

Comprehensive system, hardware, and software inventory collection

Data CollectedLinuxWindowsmacOS
System Info (hostname, CPU, RAM)✓✓✓
Installed Programs✓✓✓

Software Usage

Every 4 hours

Software usage patterns and execution history

Data CollectedLinuxWindowsmacOS
Execution History (Prefetch, BAM, Access Times)✓✓✓

Runtime State

Every 30 minutes

Running processes, services, and active sessions

Data CollectedLinuxWindowsmacOS
Running Processes & Active Users✓✓✓

Installation Paths

Linux

Binary
/usr/local/bin/licenseware-collector

Windows

Binary
C:\Program Files\Licenseware\collector.exe

macOS

Binary
/usr/local/bin/licenseware-collector

Installation Guide

1

Get Your Token

  1. Go to LICENSEWARE and sign in or create a free account
  2. Navigate to LC App and go to API Keys tab
  3. Click Create Key, configure it, and copy the token
2

Download and Install

Linux / macOS

⚠️ Requires root privileges

  1. Set your token as an environment variable
    export LICENSEWARE_TOKEN="your-token-here"
  2. Run the install script
    curl -sSL https://licenseware-collector.com/install.sh | sudo bash -s -- -t $LICENSEWARE_TOKEN

Windows

⚠️ Requires Administrator privileges

  1. Load token into environment variable
    Option A: From file (recommended) Create token.txt with your token pasted in the file, then run:
    $env:LICENSEWARE_TOKEN = Get-Content token.txt -Raw
    Option B: Directly paste token
    $env:LICENSEWARE_TOKEN = "your-token-here"
  2. Download the installer
    Invoke-WebRequest -Uri https://cdn.licenseware-collector.com/LicensewareCollector.exe -OutFile LicensewareCollector.exe
  3. Run the installer
    .\LicensewareCollector.exe
    The installer reads the token from the environment variable and registers automatically.

Quick Reference

Agent Intervals

  • Config Refresh: 30 mins
  • Catalog Check: 30 mins
  • Failed File Cleanup: 6 hours

Service Commands

  • licenseware-collector register --token <TOKEN>
  • licenseware-collector status
  • licenseware-collector stop
  • licenseware-collector run-once