Project NIDS

Secure Administrator Access

Project NIDS

Control Center

Welcome back, Admin

Critical Alert Notification Recipient
Not Authenticated
Isolated Workspace Active

Total Packets

0

Suspicious

0

Critical Threats

0

Sensor Health

ACTIVE

Traffic Intensity (PPS)

Threat Distribution

Detailed Intrusion Logs

Time Source IP Signature / Rule Matched Action Delete

Sensor Deployment Center

Deploy the sensor instantly on Linux using the automated script.

Linux Deployment

Automated Linux Setup

Clones the repository shallowly, configures environment components, and runs the provisioning script.

git clone --depth 1 https://github.com/TestiJJ/Main-NIDS.git && cd Main-NIDS && chmod +x install.sh && sudo ./install.sh

Sensor Installation & Operations Guide

1. Prerequisites & What Gets Installed

The automated installation script handles dependencies automatically, setting up the following components on your Linux host:

  • OS: Ubuntu / Debian / Linux Mint (Recommended)
  • Engine: Suricata NIDS packet inspection engine
  • Runtime: Python 3 with required pip dependencies (Firebase integration & log parsers)
  • Privileges: Root / Sudo access to read network interfaces and system logs
2. Installation & Startup Instructions
  1. Open your Linux terminal and execute the automated clone and deploy command provided above.
  2. Input your system sudo password when prompted so the script can configure network hooks and dependencies.
  3. Authenticate your sensor node or ensure your configuration file points to your authorized Firebase UID database path.
  4. Start the sensor bridge service to begin harvesting logs and streaming real-time telemetry straight to your control center dashboard.
3. Troubleshooting & Support
Minor Errors (Path/Permission Warnings)

If log paths fail or permissions deny access, ensure you are running the script with sudo and that your active network interface matches your connection config (check via ip a).

Critical Errors & Support Contact

If you experience persistent provisioning blocks or database sync crashes, reach out directly to the developer at testimonyjokotoye65@gmail.com with your terminal error logs.

Encountering Git Timeout / SSL Errors?

If your network drops or throws a GnuTLS/RPC timeout error during cloning, run these commands first to stabilize your buffer:

git config --global http.postBuffer 1048576000
git config --global http.lowSpeedLimit 0
git config --global http.lowSpeedTime 999999

Once configured, retry your copy-pasted deployment command.

Organization Custom Detection Rules

Define targeted signature keywords and custom IP watchlists for your sensor.

alert icmp any any -> $HOME_NET any (msg:"[SCAN] ICMP Ping Detected"; itype:8; sid:1000001;) SYSTEM DEFAULT