Skip to main content

Getting Started with NetSenX

NetSenX is a behavioral network threat detection platform built for NIS2 compliance. This guide will get you from zero to your first alert in under 30 minutes.

Prerequisites​

  • A NetSenX account (register here)
  • A Linux server or Windows machine to monitor
  • Python 3.8+ installed on the target machine

Quick Start​

1. Register and choose a plan​

Go to app.netsenx.com/register and create your account. Choose a plan — Free includes 3 devices and 8 detection rules.

2. Get your license key​

After login, go to Agents -> Deploy Agent. Copy your license key.

3. Install the agent​

Linux / macOS (one command):

curl -fsSL https://install.netsenx.com | sudo bash -s -- --key YOUR_LICENSE_KEY

Windows (PowerShell as Administrator):

iex "& { $(irm https://install.netsenx.com/win) } -Key YOUR_LICENSE_KEY"

4. Verify in dashboard​

Go to app.netsenx.com/agents — your device should appear within 60 seconds with status Online.

5. Your first alert​

The agent starts monitoring immediately. To generate a test alert:

nmap -sS localhost  # triggers a port-scan detection

Check app.netsenx.com/alerts for your first detection.

What Happens Next​

  • The agent silently monitors network flows in the background
  • Alerts appear in real-time in the Live Center and Alerts pages
  • Each alert includes a SHAP waterfall explaining why it was flagged
  • For CRITICAL alerts, you can generate NIS2 Art.23 PDF reports in one click

Architecture Overview​

[Your Network]
     |
  NetSenX Agent  <-- monitors flows, runs NDR engine locally
     |
  api.netsenx.com  <-- receives alerts, stores in Supabase (EU)
     |
  app.netsenx.com  <-- dashboard for analysis, compliance, management

The agent captures flow metadata only (source/destination IP, port, protocol, byte counts, timing). Packet payloads are never captured, stored, or transmitted.