Manual Installation

Recommended for testing and small deployments

Windows Installation

1. Run as Administrator: Right-click installer → "Run as administrator"
2. Installation Wizard: Follow the setup wizard
3. Enter Installation Key: Provide the key when prompted
4. Configure Options:
5. Installation directory (default recommended)
6. Complete Installation: Restart may be required

Command Line Installation:

Run this from the folder where you saved the installer, substituting the name of the file you downloaded:

msiexec /i superit-agent-amd64.msi INSTALLKEY="your-key" /quiet /norestart

Automated Scripts

For bulk deployment scenarios

$PSVersionTable.PSVersion

Get-ExecutionPolicy -List

powershell.exe -ExecutionPolicy Bypass -File install-superit.ps1

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

$proxyCred = New-Object System.Management.Automation.PSCredential("domain\proxyuser",
    (ConvertTo-SecureString "proxypassword" -AsPlainText -Force))
$proxyUri = "http://proxy.example.com:8080"

$latest = Invoke-RestMethod -Uri "https://updates.superit.ai/latest.json" -Proxy $proxyUri -ProxyCredential $proxyCred
Invoke-WebRequest -Uri $installerUrl -OutFile $installerPath -Proxy $proxyUri -ProxyCredential $proxyCred

PowerShell Script (Windows)

# Download and install SuperIT Agent
# Log in to SuperIT, navigate to Devices in the correct team, and generate an installation key
$installKey = "your-installation-key"

# Get latest version info
$latest = Invoke-RestMethod -Uri "https://updates.superit.ai/latest.json"

# Detect architecture — check PROCESSOR_ARCHITEW6432 first so that a 32-bit or
# AMD64-emulated PowerShell process on an ARM64 machine still gets the correct MSI
$arch = if ($env:PROCESSOR_ARCHITECTURE -eq "ARM64" -or $env:PROCESSOR_ARCHITEW6432 -eq "ARM64") { "arm64" } else { "amd64" }
$installerUrl = $latest.platforms.windows.$arch.url
if (-not $installerUrl) {
    Write-Error "Could not read installer URL from latest.json (arch: $arch). Check https://updates.superit.ai/latest.json is reachable and the schema is unchanged."
    exit 1
}
$installerPath = "$env:TEMP\superit-agent-$arch-$($latest.version).msi"

# Download installer
Invoke-WebRequest -Uri $installerUrl -OutFile $installerPath

# Install silently (path and key quoted to handle spaces)
Start-Process msiexec.exe -Wait -ArgumentList "/i `"$installerPath`" INSTALLKEY=`"$installKey`" /quiet /norestart"

# Verify installation (service name includes version, e.g. "SuperIT - v0.441")
if (Get-Service "SuperIT*" -ErrorAction SilentlyContinue) {
    Write-Output "SuperIT Agent installed successfully"
} else {
    Write-Error "Installation failed"
}

Group Policy Deployment (Windows)

Recommended for Windows environments with Active Directory

Prepare Group Policy

1. Create GPO: Create a new Group Policy Object named "SuperIT Agent Deployment"
2. Copy Installer: Place the latest MSI installer in a network share accessible by all computers. Download it from the portal, or fetch the current release directly onto the share:

   $latest = Invoke-RestMethod -Uri "https://updates.superit.ai/latest.json"
   Invoke-WebRequest -Uri $latest.platforms.windows.amd64.url -OutFile "\\server\share\superit-agent-amd64.msi"

3. Link GPO: Link the GPO to the appropriate Organizational Units

Configure Software Installation

Computer Configuration → Policies → Software Settings → Software Installation
1. Right-click → New → Package
2. Browse to \\server\share\superit-agent-amd64.msi
3. Select "Advanced" deployment method
4. Configure properties:
   - Install this application at logon: Yes
   - Uninstall this application when it falls out of scope: No

Configure Installation Parameters

Create a transform file (.mst) or use command line parameters:

INSTALLKEY="your-installation-key-here"

Deploy and Monitor

1. Apply GPO: Use gpupdate /force to apply immediately for testing
2. Monitor Installation: Check Event Viewer for installation success/failure
3. Verify Registration: Confirm devices appear SuperIT -> Devices

Mobile Device Management (MDM)

Recommended for modern, cloud-managed environments

Microsoft Intune

1. Upload App: Go to Apps → All apps → Add
2. Select App Type: Choose "Line-of-business app"
3. Upload Package: Upload the appropriate installer (.msi, .pkg, or .apk)
4. Configure App Information:
5. Name: SuperIT Agent
6. Description: Intelligent IT support monitoring agent
7. Publisher: SuperIT
8. Configure Installation Commands (use the filename of the package you uploaded):

   Install: msiexec /i superit-agent-amd64.msi INSTALLKEY="key" /quiet
   Uninstall: msiexec /x {product-guid} /quiet

9. Assign to Groups: Deploy to appropriate device or user groups
10. Monitor Deployment: Use Intune reporting to track installation status

Checking the agent status

Windows:

sc query SuperIT

Windows powershell:

Get-Service "SuperIT*"

Reading the agent logs, these can be found here

Windows powershell:

get-content -path C:\ProgramData\SuperIT\superit.log -tail 10

Agent startup / shutdown events are published to the windows event logs

Windows logs -> Application -> Source (SuperIT)

Confirm registration through the SuperIT dashboard

1. Access Dashboard: Log in to SuperIT portal
2. Navigate to Devices: Go to Devices → Agent Status
3. Verify Registration: Confirm new devices appear with "Online" status
4. Check Data Collection: Verify system metrics are being collected