π SecureWatch Quick Start - v2.1.0ΒΆ
π Documentation Navigation: Main README | Deployment Guide | Architecture Setup | Port Configuration
β Platform Ready!ΒΆ
Your SecureWatch SIEM platform v2.1.1 is fully operational with:
β 8 core microservices (optimized from 12+)
β Enterprise Next.js 15 frontend with full TypeScript support
β Consolidated analytics engine with dashboard APIs
β Production-ready TimescaleDB with performance optimizations
β Enhanced CLI dashboard for monitoring
β Zero TypeScript compilation errors across all packages
β Next.js 15 App Router compatibility with async route handlers
β Complete type safety for all SIEM components
π― Quick StartΒΆ
Option 1: Enterprise Startup (Recommended)ΒΆ
cd /Users/ian/Scripts/SecureWatch
# Start everything with health monitoring
./start-services.sh
# Access the platform
open http://localhost:4000
# Monitor services with CLI dashboard
./cli-dashboard.sh enhanced
Option 2: Using MakefileΒΆ
# Start all services
make up
# Check service health
make status
# Access monitoring dashboard
make dashboard
Option 3: Manual Service ManagementΒΆ
# Start infrastructure
docker compose -f docker-compose.dev.yml up -d
# Start services individually with pnpm
cd apps/search-api && pnpm run dev # Port 4004
cd apps/auth-service && pnpm run dev # Port 4006
cd apps/log-ingestion && pnpm run dev # Port 4002
# Verify TypeScript compilation (should show zero errors)
pnpm run typecheck
cd apps/analytics-engine && pnpm run dev # Port 4009
cd apps/correlation-engine && pnpm run dev # Port 4005
cd apps/query-processor && pnpm run dev # Port 4008
cd apps/mcp-marketplace && pnpm run dev # Port 4010
cd apps/hec-service && pnpm run dev # Port 8888
# Start frontend
cd frontend && pnpm run dev # Port 4000
ποΈ Current Architecture (v2.1.0)ΒΆ
8 Core ServicesΒΆ
Service |
Port |
Purpose |
|---|---|---|
Frontend |
4000 |
Enterprise Next.js application |
Log Ingestion |
4002 |
Data ingestion and processing |
Search API |
4004 |
KQL queries and search |
Correlation Engine |
4005 |
Real-time correlation and rules |
Auth Service |
4006 |
Authentication and authorization |
Query Processor |
4008 |
Async job processing |
Analytics Engine |
4009 |
Dashboard APIs (consolidated) |
MCP Marketplace |
4010 |
MCP integrations |
HEC Service |
8888 |
Splunk-compatible HTTP Event Collector |
π Verify Service HealthΒΆ
Quick Health CheckΒΆ
# Check all services at once
make status
# Individual service checks
curl http://localhost:4000/api/health # Frontend
curl http://localhost:4002/health # Log Ingestion
curl http://localhost:4004/health # Search API
curl http://localhost:4005/health # Correlation Engine
curl http://localhost:4006/health # Auth Service
curl http://localhost:4008/health # Query Processor
curl http://localhost:4009/health # Analytics Engine
curl http://localhost:4010/health # MCP Marketplace
curl http://localhost:8888/health # HEC Service
π― First StepsΒΆ
Access Platform: Open http://localhost:4000
Upload Data: Go to Settings β Log Sources
Search Events: Use the Explorer tab with KQL queries
View Analytics: Check the Dashboard for real-time metrics
Monitor Services: Use
./cli-dashboard.sh enhanced
π Key Configuration FilesΒΆ
SecureWatch/
βββ .env # Environment variables (required)
βββ docker-compose.dev.yml # Infrastructure services
βββ start-services.sh # Enterprise startup script
βββ Makefile # 30+ developer commands
βββ turbo.json # Build pipeline config
βββ pnpm-workspace.yaml # Monorepo workspace
βββ frontend/ # Next.js application
βββ apps/ # 8 microservices
βββ infrastructure/ # Database schemas & configs
π οΈ TroubleshootingΒΆ
Services Not StartingΒΆ
# Check port conflicts
make fix-ports
# Reset and restart
make clean
./start-services.sh
Database IssuesΒΆ
# Reset database
make db-reset
make db-init
Build ErrorsΒΆ
# Clean and rebuild
pnpm run clean
pnpm install
pnpm run build
π Success!ΒΆ
Your SecureWatch SIEM v2.1.0 is ready! The platform provides:
Enterprise-grade SIEM capabilities
Splunk-compatible data ingestion
Real-time correlation and alerting
Advanced analytics with KQL support
Professional UI with dark theme
Next Steps:ΒΆ
Explore the enhanced dashboard features
Set up correlation rules for threat detection
Configure data sources and ingestion
Use the CLI dashboard for monitoring