Pro onboarding

Stand up your control plane in about 10 minutes

WinSentinel Pro is the brain on top of agents you already run. The free winsentinel agent daemon does the work on each box; Pro gives you one place to see them all and command them together. Here is the whole flow — five steps, real commands, copy-paste ready.

Before you start

  • A Pro license key in the form WSP-XXXX-XXXX-XXXX. Do not have one yet? Get early access, or start a trial.
  • Windows 10/11 or Windows Server on each machine you want in the fleet.
  • Outbound HTTPS from each machine to your control plane (the agent phones home — nothing needs to reach into your network).

Free first: every machine can run the full WinSentinel audit on its own with no license at all. You only need Pro when you want them managed together.

1

Install the free CLI on every machine

WinSentinel ships as a .NET global tool on NuGet. Install it once per machine — this is the same free CLI everyone uses for single-machine audits.

PowerShell — on each node
dotnet tool install --global WinSentinel.Cli

# already installed? make sure you are current
dotnet tool update --global WinSentinel.Cli
winsentinel --version

No .NET SDK on a machine? The agent also ships as a standalone install — see the README for the MSIX / winget options.

2

Activate Pro on the admin machine

Activation is per-user, not per-machine. Run it once where you will drive the fleet from. The key is verified, then cached locally with a 30-day offline grace window so a flaky connection never locks you out.

PowerShell — admin machine
winsentinel pro activate WSP-7Q2K-9F3M-X8AB

# confirm the license is active
winsentinel pro status

The license is written to %APPDATA%\WinSentinel\license.json. Just trying it out? winsentinel pro start-trial begins a 14-day trial instead.

3

Enroll each machine as an agent

On every machine you want managed, start the agent daemon with your license. It registers with the control plane, identifies itself by license key plus a per-machine fingerprint, and sends a heartbeat every five minutes. The agent is free — pointing it at a control plane is the Pro part.

PowerShell — on each node
# register this machine and start heartbeating
winsentinel agent start --license WSP-7Q2K-9F3M-X8AB

# run it as a background Windows service (survives reboots)
winsentinel agent install --license WSP-7Q2K-9F3M-X8AB

Without a Pro license the same daemon still runs — it just audits and monitors locally instead of reporting to a control plane. Nothing about the free experience changes.

4

Verify the fleet reports in

Give it a minute for the first heartbeats to land, then check from the CLI or the web console at console.winsentinel.ai. New nodes show as Active; a node that has not checked in for 15 minutes flips to Stale.

PowerShell — admin machine
# headline view: totals, active/stale, avg score
winsentinel fleet status

# list every registered node (JSON for scripting)
winsentinel fleet nodes --json

Prefer a dashboard? Open console.winsentinel.ai, paste the same license key, and you will see every node, score, and alert on one screen.

5

Run your first fleet-wide scan

Now the payoff: scan the whole fleet from one command, push a hardening baseline, and pull an org-wide compliance rollup for auditors — no logging into each box.

PowerShell — admin machine
# scan every node, or a subset, or specific modules
winsentinel fleet scan-all
winsentinel fleet scan-all --nodes db-prod-1,db-prod-2 --modules defender,firewall

# push a CIS L1 baseline to the whole fleet
winsentinel fleet push-policy --file cis-l1.json

Compliance rollups (CIS L1 / SOC2 / HIPAA) and drift alerts populate automatically as scans report in. Export to PDF or CSV from the console Compliance tab.

Once nodes are reporting, you get

✓ Fleet-wide posture on one dashboard
✓ Remote scan / fix / policy dispatch
✓ Drift & regression alerts (Slack / Teams / webhook)
✓ Org compliance rollups (CIS L1 / SOC2 / HIPAA)
✓ RBAC — admin / viewer / auditor roles
✓ Full API access + immutable audit log

Troubleshooting

A node is not showing up

Heartbeats land every five minutes, so allow a few minutes after agent start. Then confirm the machine can reach your control plane over HTTPS (a proxy or egress firewall is the usual culprit) and that the agent was started with the right --license key. winsentinel agent status prints the last successful check-in.

This command requires a Pro license

Fleet commands (fleet status / scan-all / push-policy / nodes) are Pro-gated. Run winsentinel pro activate <key> on that machine first. Single-machine commands (audit, monitor, fix) never require a license.

A node shows as Stale

Stale means no heartbeat for 15+ minutes — usually the machine is offline/asleep or the agent service stopped. Install the agent as a Windows service (winsentinel agent install) so it restarts on boot.

Can I script this across many machines at once?

Yes — the enroll step is a single command, so push it with your existing tooling (GPO startup script, Intune, Ansible, a PDQ/SCCM package). Bake the --license key into the deployment and every machine self-registers on first run.

That is the whole setup

Install free, activate Pro once, enroll your machines, and you are managing the fleet from one place. No servers to run — the control plane is hosted.