Download and Verify
Check the supported platforms first. Then download the installer and verify its SHA-256 hash before you install or package it.
Release rings
Each workspace is on a release ring, which controls how early it receives new agent versions:
- Canary: used by the SparkLogs engineering team for quality assurance.
- Early Access: receives each new version as soon as it is publicly released, after SparkLogs engineering has tested it.
- Stable: receives updates after Early Access.
SparkLogs sets each workspace's ring.
The download path and version follow your workspace's ring. The app's agent deploy wizard shows you the exact ring, version, download URL, and expected hash for your environment.
Copy-paste examples on this site use the current published Windows x64 EXE (1.14.13):
https://cdn.sparklogs.app/agent/data/1.14.13/windows_x86_64/sha256_c01da4bb31617cef850abda814f49037b38a9620271dc79f323d542f4cf550be/SparkLogsAgentSetup-x64-1.14.13.exe
SHA-256: c01da4bb31617cef850abda814f49037b38a9620271dc79f323d542f4cf550be
EXE vs MSI
- EXE: the standard installer for single-machine and RMM silent installs. The smallest download.
- MSI: required for Group Policy (GPO) and Microsoft Intune, which package the installer. Group Policy Software Installation does not support EXE.
Verify the SHA-256
Verify the file hash before installing or packaging. Compare the output to the expected hash shown in the deploy wizard, and stop if there is a mismatch:
Get-FileHash -Algorithm SHA256 .\SparkLogsAgentSetup-x64-1.14.13.exe | Format-List
Install properties
These properties are supplied at install time (on the command line, or in a GPO transform). The downloaded installer is the same for every workspace and carries no token, so you supply the properties yourself.
| Property | When | Meaning |
|---|---|---|
EULA=ACCEPT | every silent install | Accepts the SparkLogs Agent license. The interactive installer prompts for it instead. |
REGISTRATION_TOKEN | always | The registration token. Scopes the agent to one workspace and the token's organization subtree. |
USEPARENTORG=1 | single-org | Register directly under the token's organization and create no client organization. Required for single-org installs. With this set, CLIENTNAME is not used. |
RMMCLIENTID | client-org | Your RMM's per-client ID. A linking key: the agent auto-creates or links the matching child organization. |
PSACLIENTID | client-org | Your PSA's per-client ID. A linking key, also used for ticket and billing reconciliation. Use the RMM ID, PSA ID, or both. |
CLIENTNAME | optional | Display-name override for the auto-created client organization. Not a link key. If omitted, the name is the AD domain, then the RMM ID, then the PSA ID. Quote values with spaces. Not used for single-org. |
Command forms:
- EXE:
SparkLogsAgentSetup-x64-1.14.13.exe /qn /norestart EULA=ACCEPT PROP=VALUE ... - MSI:
msiexec /i SparkLogsAgent-x64-1.14.13.msi /qn /norestart EULA=ACCEPT PROP=VALUE ... /l*v %TEMP%\SparkLogsAgent-install.log
Sample tokens are shown as us_97....
The app's deploy wizard shows each command with your real token.
If your workspace ring is not this build, use the deploy wizard for the URL and hash.