Skip to content

Latest commit

 

History

24 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 

Repository files navigation

Wazuh SIEM Deployment with Docker (Single Node) & VPS Deployment

Overview

This project demonstrates hands-on Security Operations Center (SOC) experience by deploying Wazuh SIEM in a Docker-based single-node environment on Windows. The lab covers Wazuh architecture, secure deployment using certificates, and access to the Wazuh dashboard for monitoring and alerting.

The goal of this project is to showcase practical skills in SIEM deployment, log management, and containerized security infrastructure—skills directly relevant to junior SOC analyst and cybersecurity roles.

📁 Phase 2 link: vps-agent-deployment/README.md


Technologies Used

  • Wazuh (SIEM / XDR)
  • Docker & Docker Compose
  • Windows OS
  • Git

Wazuh Architecture (Simple Explanation)

  • Wazuh Agent – Collects logs and security events from endpoints
  • Wazuh Server – Analyzes logs using decoders and rules
  • Wazuh Indexer – Stores and indexes security data
  • Wazuh Dashboard – Web interface for monitoring alerts and system status

Analogy:

  • Agent → Security cameras & sensors
  • Server → Control center
  • Indexer → Video storage
  • Dashboard → Monitoring screens

Deployment Model

Single-node Docker deployment

  • All Wazuh components run on a single host
  • Each component runs in its own container
  • Suitable for labs, testing, and learning environments

Prerequisites

  • Docker Desktop
  • Git for Windows
  • Minimum 4 GB RAM
  • At least 10 GB free disk space

Deployment Steps

1. Clone the Wazuh Docker Repository

git clone https://github.com/wazuh/wazuh-docker.git

CMD

Navigate to the single-node deployment directory:

cd wazuh-docker/single-node

2. Generate Self-Signed Certificates

Wazuh uses certificates to secure communication between components. For this lab, self-signed certificates are used.

docker compose -f generate-indexer-certs.yml run --rm generator

CMD


3. Start the Wazuh Stack

docker compose up -d

CMD

This launches the Wazuh server, indexer, and dashboard containers.


4. Access the Wazuh Dashboard

Open a browser and navigate to:

https://localhost

Web-browser

A browser security warning is expected due to self-signed certificates.

  • Click Advanced
  • Select Proceed to localhost (unsafe)

Web-browser

Log in using the default credentials provided in the Wazuh documentation.

Web-browser


Validation

  • Wazuh dashboard accessible via browser
  • All containers running successfully
  • Indexer receiving and storing data
  • Dashboard displaying system status

SOC Relevance

This project demonstrates:

  • SIEM deployment and configuration
  • Log ingestion and analysis workflow
  • Docker-based security tooling
  • Understanding of Wazuh architecture and components

Future Improvements

  • Deploy and enroll Wazuh agents
  • Generate and analyze security alerts
  • Add custom detection rules
  • Forward logs from Windows endpoints

Phase 2: VPS-Based Wazuh Deployment with Remote Agent

This project was extended beyond a local Docker lab by deploying Wazuh on a public Contabo VPS and enrolling a remote Windows endpoint over the internet.

This phase focused on:

  • Running Wazuh in a 24/7 cloud environment
  • Enrolling agents across network boundaries
  • Troubleshooting real-world issues such as NAT, duplicate agent identities, and authentication failures
  • Validating end-to-end agent-to-manager communication

📁 Detailed documentation:
vps-agent-deployment/README.md

Disclaimer

This deployment is intended for learning and lab purposes only and should not be used in production without proper hardening and security controls.


Author

Abdur Rahman Khan


About

A hands-on SOC lab deploying Wazuh SIEM in a Docker-based single-node environment on Windows. Demonstrates SIEM architecture, secure containerized deployment, and log monitoring fundamentals.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors