Skip to content
Computer agents

Computers that report themselves

The RaqeebHQ agent is a small script that runs as a scheduled task or system timer, checks in once an hour and sends the computer's specifications and installed software to your portal. Your register fills itself and stays current.

Windows

Windows 10, 11 and Server 2016+.

macOS

The same one-line install pattern with the macOS script.

Linux

Ubuntu, Debian, RHEL, Fedora and others.

Install in one line

Copy, paste, done

Copy the command from Agents › Add a computer and paste it on the computer as administrator.

runsend a report now
collectprint the report without sending it
statusshow settings and the last result
uninstallremove the agent; the asset and its history stay

Revoking a computer's key from the portal stops it reporting immediately.

# PowerShell as Administrator · Windows 10, 11, Server 2016+

& ([scriptblock]::Create((irm 'https://YOUR-SERVER/api/agent/script.ps1'))) `
  -Install -Server 'https://YOUR-SERVER' -Key '••••••••'

Safe install keys

Install commands are generated after the admin re-enters their password. Each computer gets its own single-use key, shown once, with a chosen expiry (24 hours by default).

Inbox first

New computers wait under New devices until someone registers them as a new asset or links them to an existing one. Matching serial numbers are suggested, and the category is suggested from the hardware.

Change detection

Hardware (CPU, cores, memory, disks, graphics, serial, model, OS, IP) and software (installed, updated, removed) changes are logged on the asset and can trigger email alerts.

raqeebhq › /app/agents
Agents page: registered computers with hostname, asset tag, holder, OS, hardware, IP and last seen
Sample agents reporting

Ten computers, three operating systems, one view

The computers reporting to the Gulf Horizon Trading demo workspace. Eight are registered and linked to assets; two have just appeared and wait in the inbox.

ComputerAsset · holderOperating systemHardwareIPState
GHT-FIN-LT01LaptopAST-0001Ahmed Rahman · FinanceWindows 11 Pro24H2 (26100.2033)Dell Latitude 7450Core Ultra 7 165U · 32 GB · 512 GB10.20.12.41
Registered
GHT-SAL-LT02LaptopAST-0002Omar Haddad · SalesWindows 11 Pro24H2 (26100.2033)Dell Latitude 7450Core Ultra 7 165U · 32 GB · 512 GB10.20.12.57
Registered
GHT-SAL-LT03LaptopAST-0003IT Store Room (spare)Windows 10 Pro22H2 (19045.4894)Dell Latitude 5550Core Ultra 5 125U · 16 GB · 256 GB10.20.12.120
Registered
Mariams-MacBook-ProLaptopAST-0004Mariam Al Suwaidi · SalesmacOS Sequoia15.0.1 · arm64MacBook Pro 14″ M4Apple M4 Pro · 24 GB · 1 TB10.20.12.63
Registered
GHT-AUH-LT07LaptopAST-0006Rajesh Menon · OperationsWindows 11 Enterprise23H2 (22631.4317)ThinkPad T14 Gen 5Ryzen 7 PRO 8840U · 32 GB · 512 GB10.30.4.22
RegisteredRAM 16 → 32 GB
GHT-HR-DT01DesktopAST-0009Layla NasserWindows 11 Pro24H2 (26100.2033)OptiPlex Tower 7020Core i7-14700 · 16 GB · 1 TB10.20.12.88
Registered
Fatimas-iMacDesktopAST-0010Fatima Al Hashimi · ITmacOS Sequoia15.0.1 · arm64iMac 24″ M4Apple M4 · 16 GB · 512 GB10.20.12.15
Registered
ght-dxb-app01ServerSRV-0001Server RoomUbuntu 24.04.1 LTSkernel 6.8.0-45Dell PowerEdge R760Xeon Silver 4410Y · 128 GB · 3.84 TB10.20.1.10
Registerednginx updated
GHT-IT-LT09LaptopNot yet an assetWindows 11 Pro24H2 (26100.2033)HP EliteBook 840 G11Core Ultra 5 135U · 16 GB · 512 GB10.20.12.97
New device
ght-dxb-build02DesktopNot yet an assetUbuntu 22.04.5 LTSkernel 5.15.0-122OptiPlex Micro 7010Core i5-13500T · 32 GB · 1 TB10.20.1.24
New device

What a check-in contains

{
  "hostname": "GHT-AUH-LT07",
  "os": { "name": "Microsoft Windows 11 Enterprise" },
  "hardware": {
    "manufacturer": "LENOVO",
    "version": "ThinkPad T14 Gen 5",
    "serial": "PF5T14G5Q7"
  },
  "cpu": { "model": "AMD Ryzen 7 PRO 8840U", "cores": 8 },
  "memory": { "total_kb": 33554432 },
  "disks": [ … ], "network": [ … ], "software": [ … ]
}

What the portal did with it

  • Matched the serial to asset AST-0006 and updated its device profile.
  • Detected Memory 16 GB → 32 GB and Power BI Desktop installed; logged in the change log and the asset's history.
  • Detected nginx 1.24 → 1.26 and redis-server installed on ght-dxb-app01.
  • Marked all ten computers as seen within the last 2 hours.
Privacy

Specs only. Never people.

The agent does not send usage data such as CPU load, free memory, browsing or who is signed in. It reports hardware, OS, network and installed software, and never screens, files, browsing or keystrokes. Uninstalling it removes the agent; the asset and its history stay.

raqeebhq › /app/assets/SRV-0001
Device specifications reported by the agent on a Dell PowerEdge server: OS, processor, memory and storage

See your estate clearly, starting today.

Start a 30-day free trial on Starter with no card, install the agent on a few computers and watch your register fill itself.