Skip to content

Repository files navigation

🛡️ CyberGuard SaaS

Enterprise-Grade Forensic Incident Response Platform
Secure. Scalable. Admissible.


🚀 Quick Start (Development)

The development environment includes hot-reloading and simulated agents.

./start.sh

🧠 Local AI (Live + Deep)

Live AI (Local, always-on) runs via Ollama for fast, safe summaries and next steps.
Deep AI (On-demand) also runs locally when a user explicitly clicks “Run Deep Analysis”.

Recommended local model (from your Ollama list):

OLLAMA_MODEL=mistral:7b-instruct-q5_K_M

🌐 Cross-Platform Start

Agent: Run the agent as Administrator (Windows) or root (Linux) for full visibility and prevention (firewall, process/network scan, config read). The start scripts will re-launch elevated if needed.

Windows (PowerShell)

.\start.ps1
# Agent: run as Administrator (script will prompt to elevate if needed)
.\agent\start_agent.ps1

Windows (CMD)

start.cmd
REM Agent: right-click PowerShell -> Run as Administrator, then:
agent\start_agent.ps1

macOS / Linux

./start.sh
# Agent: run as root (script will re-exec with sudo if not root)
sudo ./agent/start_agent.sh

🔄 Auto-Update Scripts

macOS / Linux

./scripts/update.sh

Windows (PowerShell)

.\scripts\update.ps1

Windows (CMD)

scripts\update.cmd

🧩 System Services

Linux (systemd)

The agent service runs as root for full capability. Copy service files from deploy/systemd/ to /etc/systemd/system/, then:

sudo systemctl daemon-reload
sudo systemctl enable cyberguard-backend cyberguard-frontend cyberguard-agent
sudo systemctl start cyberguard-backend cyberguard-frontend cyberguard-agent

Windows Services

Run as Administrator:

.\deploy\windows\install_services.ps1 -Root "C:\cyberguard"
Start-Service CyberGuardBackend
Start-Service CyberGuardAgent

Remove:

.\deploy\windows\uninstall_services.ps1

☁️ Production Deployment

We provide a 1-Click Deployment Script for Cloud environments (AWS/GCP/Azure).

cd deployment && ./DEPLOY_PROD.sh

Architecture:

  • Frontend: Next.js (Standalone Alpine Container)
  • Backend: FastAPI (Non-root user, optimized)
  • Database: PostgreSQL 15 (Isolated Network)
  • Gateway: Nginx (TLS Termination)

📚 Documentation for Reviewers

💎 Key Differentiators

  1. Chain of Custody: We don't just log actions; we cryptographically sign them (SHA-256).
  2. Multi-Tenancy: Built from day one for Service Providers (MSSPs).
  3. SaaS-Ready: User Management, RBAC, and Billing hooks are pre-integrated.

Ready for Demo Day 2026

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages