Help & FAQ
Everything you need to know about SysXray — plain English, no tech jargon.
Getting Started
What is SysXray?
SysXray lets you see exactly what's happening inside your Mac — in real time. CPU usage, memory, which apps are running, how hot your Mac is, what's using the most space, and more. All from a clean dashboard you can access from any browser.
What is the agent?
The agent is a small background program that runs silently on your Mac. It collects data every 10 seconds and sends it to your SysXray dashboard. Without it, the dashboard has nothing to show. Think of it like the sensor — the dashboard is the screen that displays what the sensor reads.
Installing the agent
  1. Log in to your dashboard at sysxray.com/dashboard
  2. Click + Add Mac in the top bar
  3. Copy the install command shown — it's unique to your account
  4. Open Terminal on your Mac (search "Terminal" in Spotlight)
  5. Paste the command and press Enter
  6. Done. Your Mac will appear in the dashboard within 30 seconds
The install command automatically sets up auto-start — the agent will run every time you turn on your Mac. You never need to touch Terminal again after this one step.
Agent & Auto-Start
Does it start automatically?
Yes. The install command sets up two layers of auto-start so the agent is always running:

Layer 1 — macOS Login Service (launchd). Starts the agent when you log in, restarts it automatically if it ever crashes.

Layer 2 — Cron backup. A second trigger at startup in case the first is ever removed by a cleaning app.
What if a cleaner app removes it?
Apps like CleanMyMac sometimes remove background services. SysXray protects against this in two ways:

1. Two separate auto-start mechanisms — both have to be removed for the agent to stop.

2. Self-healing — every time the agent runs, it checks if both layers are still in place and quietly reinstalls whichever one is missing.
How much does the agent use?
Almost nothing. The agent typically uses under 0.5% CPU and about 30–50 MB of RAM. It collects a snapshot every 10 seconds and sends a small amount of data to SysXray's servers. You will not notice it running.
Mac Shows as Offline
Why does my Mac show as offline?
Your Mac shows as offline when the dashboard hasn't received a report in the last 2 minutes. The most common reasons:

1. The agent was never set up to auto-start — it only ran once when you first installed it. Fix: click + Add Mac in the dashboard to get a fresh install command and run it again.

2. A cleaning app removed the service — see "What if a cleaner app removes it?" above.

3. Your Mac was off or sleeping — the agent pauses while asleep and resumes automatically when you wake it up.
When your Mac is offline, the dashboard shows a red banner at the top explaining what happened and what to do.
How to fix an offline Mac
Click the + Add Mac button in your dashboard (or the red banner that appears when offline). Follow the 3-step guide to get a fresh install command. Run it once and your Mac will come back online within 30 seconds.
Removing the Agent
How to fully uninstall
  1. Open Terminal and run this command to stop the agent and remove all auto-start entries:
sysxray-agent --uninstall
This removes:
  • The background service (launchd)
  • The cron backup entry
  • All auto-start — the agent will not run again on its own

  1. Then go to your dashboard, click Remove next to the Mac name, and click Delete from dashboard to remove it from your account.
Always run --uninstall on your Mac first, before deleting from the dashboard. If you delete from the dashboard first, the agent will just re-register itself the next time it runs.
Frequently Asked Questions
The agent collects system performance data only: CPU usage, memory usage, disk usage, network speed, running processes, fan speed, CPU temperature, and open network ports. It does not collect any files, documents, photos, passwords, or personal data.
Yes. All data is sent over HTTPS (encrypted). Your data is stored in your private account and is never shared with third parties. Only you can see your Mac's metrics.
Yes. Click + Add Mac for each Mac you want to monitor. Each gets its own install command. Switch between Macs using the dropdown at the top of the dashboard.
The agent sends a snapshot every 10 seconds. The dashboard checks for new data every 10 seconds as well, so what you see is essentially live — never more than 20 seconds behind.
macOS runs many background processes you never see — things like mds (Spotlight search), cloudd (iCloud sync), coreaudiod (audio engine), and dozens more. These are normal. The Diagnostic tab can tell you if any of them is causing your Mac to run slow or get hot.
It means the agent on your Mac hasn't reported in a while. The data you're seeing is frozen from the last time it did. The dashboard shows a red banner at the top when this happens, along with instructions to fix it.
Go to the Diagnostic tab in your dashboard and click "Why is my Mac loud?". It will show you the top 3 specific reasons ranked by how much each one is contributing — with real app names and real numbers, not generic guesses.
Not yet. SysXray currently supports Mac only. Windows support is planned for a future release.
Email us at ozdemir@salesforcehub.us. We typically respond within one business day.