Help & FAQ

SysXray for Windows — everything you need to get started and troubleshoot.

How do I install the agent on my PC?

Open PowerShell as Administrator: press Win, type PowerShell, right-click the result → Run as administrator. Then paste your install command from the dashboard:

$env:SYSXRAY_TOKEN='your-token-here'
Set-ExecutionPolicy Bypass -Scope Process -Force
irm https://sysxray.com/install.ps1 | iex

The installer downloads the agent, registers your PC, and installs a Windows Scheduled Task so the agent starts automatically at boot. The whole thing takes under 30 seconds.

Does Windows Terminal work? Yes — if the tab inside it is PowerShell (the default on Windows 11). The install command uses PowerShell-only syntax and will not work in Command Prompt.

What Windows versions are supported?

Windows 10 (version 1903 or later) and Windows 11. Both 64-bit only. Windows Server 2019 and 2022 also work.

Windows 8, 8.1, 7, and earlier are not supported. Windows 8.1 reached end of life in January 2023 and no longer receives security updates — we recommend upgrading to Windows 10 or 11 before installing any monitoring software.

Does it need Administrator rights?

Only during installation. The installer needs Admin to create the Scheduled Task. Once installed, the agent runs as your normal user account — no elevated permissions required at runtime.

What is the SysXray agent?

A lightweight Python process that runs silently in the background on your Windows PC. Every 10 seconds it collects a snapshot of your system — CPU, memory, processes, disk, network, thermals — and sends it securely over HTTPS to your dashboard.

It uses under 0.1% CPU and roughly 20 MB of RAM. You will never notice it running. It is not a system service — it runs as a Scheduled Task under your user account.

The agent is open-source. You can read every line at github.com/murtazaozdemir/SysXray.

What data does the agent collect?

Only system performance metrics — nothing personal:

CPU usage per core · Memory (RAM + Page File) · Running processes (name, PID, CPU%, memory, threads) · Disk drives (usage, read/write) · Network interfaces (bytes sent/received) · CPU temperature · GPU name, temperature, load, VRAM · Windows services and startup programs · Open network ports

The agent never reads your files, documents, browser history, or any application data.

How do I start, stop, or uninstall the agent?

Stop (temporary): Open Task Scheduler, find SysXrayAgent, right-click → Disable.

Start again: Same place, right-click → Enable, then Run.

Uninstall completely: Run in PowerShell as Admin:

schtasks /Delete /TN "SysXrayAgent" /F
Remove-Item "$env:APPDATA\SysXray" -Recurse -Force

Then remove the device from your dashboard using the Remove button.

Why does Windows Defender flag the agent?

Windows Defender and some antivirus tools occasionally flag Python-based executables simply because they are unsigned. The agent is open-source — you can inspect every line of code before running it. If your AV blocks it, add an exclusion for %APPDATA%\SysXray\.

We are working on code-signing the binary to eliminate this warning.

What do the tabs show?

Hardware — Live CPU (per-core bars), RAM + Page File, network bandwidth, and all disk drives with read/write speeds.

Processes — All running processes sorted by CPU usage, with memory, thread count, and user. You can kill processes directly from the dashboard.

Services — Windows services split into Running and Stopped, plus Startup Programs. You can toggle services on and off remotely.

Ports — All open TCP/UDP ports and active connections. Filter by protocol or state. Kill processes that have open ports.

Thermal — CPU temperature gauge and full GPU info (name, temperature, load%, VRAM usage).

Diagnostic — Automatic health checks across CPU, memory, disk, temperature, and Windows Update.

What does the agent status indicator mean?

● Connected — Agent reported in the last 30 seconds. All data is live.

● Disconnected — No report in over 30 seconds. PC may be asleep, off, or the agent may have stopped. Data shown is from the last known snapshot.

● Update needed — Agent is running but an update is available. Download the latest version from the Add PC modal.

Can I monitor multiple PCs?

Yes. Each device gets its own install token. Run the install command on each PC you want to monitor. Switch between devices using the device selector in the dashboard header. All devices appear under the same account.

Why are some services shown as read-only?

Services with a Disabled start type cannot be toggled from the dashboard — Windows does not allow enabling a disabled service remotely without an Admin context. You will need to change the start type in Services (services.msc) directly on your PC first.

Can I kill processes from the dashboard?

Yes, for user-owned processes. System processes (System, svchost.exe, lsass.exe, etc.) show a lock icon and cannot be killed — terminating them would crash Windows.

When you press Kill, the command is queued and executed the next time the agent checks in (within 10 seconds). A confirmation appears when done.

Is my data secure?

All data is sent over HTTPS (TLS 1.3). It is stored in your account only — no one else can access it. We do not sell or share your data with third parties.

The agent authenticates with a per-device token. Even if someone obtained your token, they could only push metrics to your account — they cannot read your files or execute arbitrary commands.

Where is my data stored?

In Supabase (Postgres), hosted on AWS in the US East region. Metric snapshots are retained for 30 days. You can delete all data for a device by removing it from the dashboard.

Dashboard says "Collecting first metrics…" but nothing appears

1. Open Task Scheduler and verify SysXrayAgent exists and is Enabled.

2. Right-click the task and choose Run to force a check-in.

3. Check if the task last ran successfully — the Last Run Result column should show (0x0).

4. If the task is missing, re-run the install command from the Add PC modal in the dashboard.

Agent shows Connected but data looks stale

The dashboard polls every 10 seconds. If data looks frozen, try a hard refresh (Ctrl + Shift + R). If it persists, open Task Scheduler and confirm the SysXrayAgent task is running every 10 seconds (not just at login).

The install script fails with "execution of scripts is disabled"

The install command sets the execution policy for the current process only (-Scope Process), so it should not be blocked. If it fails anyway, run this first in your Admin PowerShell session:

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

Then re-run the install command.

Still stuck? We read every message and reply within 24 hours.

Contact Us →   or   ozdemir@salesforcehub.us