Learn how NetNerve works

Everything you need to know — from uploading your first capture to understanding MITRE ATT&CK results.

Getting Started

Supported File Formats

NetNerve accepts .pcap and .pcapng capture files. The free tier supports files up to 2MB, while Pro and Forensics tiers support up to 20MB and 100MB respectively.

Uploading Your Capture

Simply drag and drop your packet capture file onto the upload area on the homepage, or click to browse your file system. Processing begins immediately — no configuration required.

File Privacy

Your capture file has zero persistent retention and is never stored in a database. Data is processed transiently and purged from server memory and temp sandboxes immediately after analysis.

Analysis Pipeline

Step 1 — Packet Extraction

The backend parses your capture using high-throughput tshark and scapy to extract protocol metadata, flow records, DNS queries, TLS SNI fields, and deep payload forensics.

Step 2 — AI Threat Narrative

Extracted data is sent to a large language model that generates a structured threat summary in plain English — covering anomalies, suspicious patterns, and recommended actions.

Step 3 — Suricata IDS Scan

For Forensics-tier users, the capture is simultaneously run through the Suricata intrusion detection engine with 40,000+ community and custom rules.

Step 4 — Threat Correlation

Results from the AI engine and Suricata are correlated and mapped to MITRE ATT&CK sub-techniques, producing a unified threat intelligence report.

Understanding Results

Summary Tab

The AI-generated narrative overview of your capture — including key findings, severity ratings, and recommended next steps.

Security Tab

Deep-dive into threats: Suricata alerts grouped by severity, custom rule detections, IP reputation lookups, and MITRE ATT&CK technique mappings.

Network Tab

Protocol distribution charts, top talkers by bandwidth, port analysis, and flow-level breakdowns of your network traffic.

Forensics Tab

WiFi metadata, Telnet session detection, TLS certificate analysis, DNS query logging, and plaintext credential exposure alerts.

Suricata IDS Engine

Rule Sources

NetNerve uses the Emerging Threats (ET Open) community ruleset updated daily, supplemented with custom NetNerve rules targeting specific attack patterns.

Custom Rules

Our custom ruleset includes detection for SQL injection attempts in HTTP payloads, cross-site scripting patterns, command injection sequences, and suspicious DNS tunneling.

Alert Correlation

Suricata alerts are deduplicated and correlated with the AI engine's findings. Each alert is mapped to its MITRE ATT&CK sub-technique for standardized reporting.

Zero-Trust PCAP Sanitizer

In-Memory Volatile Processing

The PCAP Sanitizer operates frame-by-frame in volatile browser memory before file export. Raw packet bytes are modified in RAM without ever touching persistent disk storage.

RFC 5737 IP Address Obfuscation

Internal RFC 1918 IPv4 addresses (10.x, 192.168.x) are deterministically mapped to anonymous RFC 5737 ranges (192.0.2.x, 198.51.100.x). Host offsets are preserved so network communication flows remain debuggable.

Payload Sanitization Modes

Full Zero-Out replaces all L5+ payload bytes with 0x00 for 100% metadata-only sharing. Selective Redaction scrubs credentials, passwords, and bearer tokens while keeping SQLi and XSS attack signatures intact for Suricata & AI detection.

Ethernet MAC Address Masking

Hardware MAC addresses are anonymized using IANA documentation OUIs (00:00:5E:00:01:xx), concealing hardware manufacturer identities.

API Reference

POST /api/upload

Upload a packet capture file for analysis. Accepts multipart/form-data with a file field. Returns a JSON response containing the full analysis payload.

Authentication

API access requires a valid Clerk session token. Include the Authorization header with your bearer token for authenticated requests.

Rate Limits

Free tier: 5 analyses per day. Pro tier: 50 analyses per day. Forensics tier: 200 analyses per day. Rate limits reset at midnight UTC.