mirror of
				https://github.com/wazuh/wazuh-docker.git
				synced 2025-11-04 05:53:19 +00:00 
			
		
		
		
	Merge pull request #1852 from wazuh/enhancement/2385-bump-4.13.0-technical-documentation
Bump 4.13.0 technical documentation
This commit is contained in:
		@@ -18,7 +18,7 @@ The `wazuh/wazuh-docker` repository provides resources to deploy the Wazuh cyber
 | 
				
			|||||||
## Branch Convention
 | 
					## Branch Convention
 | 
				
			||||||
 | 
					
 | 
				
			||||||
- `main`: Developing and testing of new features.
 | 
					- `main`: Developing and testing of new features.
 | 
				
			||||||
- `X.Y.Z`: Version-specific branches (e.g., `4.12.2`, `4.11.0`, etc.).
 | 
					- `X.Y.Z`: Version-specific branches (e.g., `4.13.0`, `4.12.0`, etc.).
 | 
				
			||||||
 | 
					
 | 
				
			||||||
## Documentation
 | 
					## Documentation
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 
 | 
				
			|||||||
@@ -13,7 +13,7 @@ This script initializes the environment variables needed to build each of the im
 | 
				
			|||||||
The script allows you to build images from other versions of Wazuh, to do this you must use the -v or --version argument:
 | 
					The script allows you to build images from other versions of Wazuh, to do this you must use the -v or --version argument:
 | 
				
			||||||
 | 
					
 | 
				
			||||||
```
 | 
					```
 | 
				
			||||||
$ build-docker-images/build-images.sh -v 4.12.2
 | 
					$ build-docker-images/build-images.sh -v 4.13.0
 | 
				
			||||||
```
 | 
					```
 | 
				
			||||||
 | 
					
 | 
				
			||||||
To get all the available script options use the -h or --help option:
 | 
					To get all the available script options use the -h or --help option:
 | 
				
			||||||
@@ -26,7 +26,7 @@ Usage: build-docker-images/build-images.sh [OPTIONS]
 | 
				
			|||||||
    -d, --dev <ref>              [Optional] Set the development stage you want to build, example rc1 or beta1, not used by default.
 | 
					    -d, --dev <ref>              [Optional] Set the development stage you want to build, example rc1 or beta1, not used by default.
 | 
				
			||||||
    -f, --filebeat-module <ref>  [Optional] Set Filebeat module version. By default 0.4.
 | 
					    -f, --filebeat-module <ref>  [Optional] Set Filebeat module version. By default 0.4.
 | 
				
			||||||
    -r, --revision <rev>         [Optional] Package revision. By default 1
 | 
					    -r, --revision <rev>         [Optional] Package revision. By default 1
 | 
				
			||||||
    -v, --version <ver>          [Optional] Set the Wazuh version should be builded. By default, 4.12.2.
 | 
					    -v, --version <ver>          [Optional] Set the Wazuh version should be builded. By default, 4.13.0.
 | 
				
			||||||
    -h, --help                   Show this help.
 | 
					    -h, --help                   Show this help.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
```
 | 
					```
 | 
				
			||||||
@@ -1,6 +1,6 @@
 | 
				
			|||||||
# Development Guide - Introduction
 | 
					# Development Guide - Introduction
 | 
				
			||||||
 | 
					
 | 
				
			||||||
Welcome to the Development Guide for Wazuh-docker version 4.12.2. This guide is intended for developers, contributors, and advanced users who wish to understand the development aspects of the Wazuh-Docker project, build custom Docker images, or contribute to its development.
 | 
					Welcome to the Development Guide for Wazuh-docker version 4.13.0. This guide is intended for developers, contributors, and advanced users who wish to understand the development aspects of the Wazuh-Docker project, build custom Docker images, or contribute to its development.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
## Purpose of This Guide
 | 
					## Purpose of This Guide
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 
 | 
				
			|||||||
@@ -1,6 +1,6 @@
 | 
				
			|||||||
# Development Guide - Setup Environment
 | 
					# Development Guide - Setup Environment
 | 
				
			||||||
 | 
					
 | 
				
			||||||
This section outlines the steps required to set up your local development environment for working with the Wazuh-Docker project (version 4.12.2). A proper setup is crucial for building images, running tests, and contributing effectively.
 | 
					This section outlines the steps required to set up your local development environment for working with the Wazuh-Docker project (version 4.13.0). A proper setup is crucial for building images, running tests, and contributing effectively.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
## Prerequisites
 | 
					## Prerequisites
 | 
				
			||||||
 | 
					
 | 
				
			||||||
@@ -26,12 +26,12 @@ Before you begin, ensure your system meets the following requirements:
 | 
				
			|||||||
Follow these steps to prepare your development environment:
 | 
					Follow these steps to prepare your development environment:
 | 
				
			||||||
 | 
					
 | 
				
			||||||
1.  **Clone the Repository**:
 | 
					1.  **Clone the Repository**:
 | 
				
			||||||
    Clone the `wazuh-docker` repository from GitHub. It's important to check out the specific branch you intend to work with, in this case, `4.12.2`.
 | 
					    Clone the `wazuh-docker` repository from GitHub. It's important to check out the specific branch you intend to work with, in this case, `4.13.0`.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
    ```bash
 | 
					    ```bash
 | 
				
			||||||
    git clone [https://github.com/wazuh/wazuh-docker.git](https://github.com/wazuh/wazuh-docker.git)
 | 
					    git clone [https://github.com/wazuh/wazuh-docker.git](https://github.com/wazuh/wazuh-docker.git)
 | 
				
			||||||
    cd wazuh-docker
 | 
					    cd wazuh-docker
 | 
				
			||||||
    git checkout 4.12.2
 | 
					    git checkout 4.13.0
 | 
				
			||||||
    ```
 | 
					    ```
 | 
				
			||||||
 | 
					
 | 
				
			||||||
2.  **Verify Docker Installation**:
 | 
					2.  **Verify Docker Installation**:
 | 
				
			||||||
 
 | 
				
			|||||||
@@ -1,6 +1,6 @@
 | 
				
			|||||||
# Reference Manual - Description
 | 
					# Reference Manual - Description
 | 
				
			||||||
 | 
					
 | 
				
			||||||
This section provides a detailed description of Wazuh-docker (version 4.12.2), its components, and its architecture when deployed using Docker containers. Understanding these aspects is key to effectively deploying and managing your Wazuh environment.
 | 
					This section provides a detailed description of Wazuh-docker (version 4.13.0), its components, and its architecture when deployed using Docker containers. Understanding these aspects is key to effectively deploying and managing your Wazuh environment.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
## What is Wazuh?
 | 
					## What is Wazuh?
 | 
				
			||||||
 | 
					
 | 
				
			||||||
@@ -18,7 +18,7 @@ Wazuh-docker is a project that provides Docker images and `docker compose` confi
 | 
				
			|||||||
 | 
					
 | 
				
			||||||
## Core Components in Wazuh-Docker
 | 
					## Core Components in Wazuh-Docker
 | 
				
			||||||
 | 
					
 | 
				
			||||||
The Wazuh-Docker project typically provides images for the following core Wazuh components, adapted for version 4.12.2:
 | 
					The Wazuh-Docker project typically provides images for the following core Wazuh components, adapted for version 4.13.0:
 | 
				
			||||||
 | 
					
 | 
				
			||||||
1.  **Wazuh Manager**:
 | 
					1.  **Wazuh Manager**:
 | 
				
			||||||
    -   The central component that collects and analyzes data from deployed Wazuh agents.
 | 
					    -   The central component that collects and analyzes data from deployed Wazuh agents.
 | 
				
			||||||
@@ -28,7 +28,7 @@ The Wazuh-Docker project typically provides images for the following core Wazuh
 | 
				
			|||||||
2.  **Wazuh Indexer**:
 | 
					2.  **Wazuh Indexer**:
 | 
				
			||||||
    -   A highly scalable, full-text search and analytics engine.
 | 
					    -   A highly scalable, full-text search and analytics engine.
 | 
				
			||||||
    -   Based on OpenSearch (or historically Elasticsearch), it stores and indexes alerts and monitoring data generated by the Wazuh manager.
 | 
					    -   Based on OpenSearch (or historically Elasticsearch), it stores and indexes alerts and monitoring data generated by the Wazuh manager.
 | 
				
			||||||
    -   The Wazuh indexer container provides the data persistence layer for Wazuh alerts and events. For version 4.12.2, this is typically an OpenSearch-based component.
 | 
					    -   The Wazuh indexer container provides the data persistence layer for Wazuh alerts and events. For version 4.13.0, this is typically an OpenSearch-based component.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
3.  **Wazuh Dashboard**:
 | 
					3.  **Wazuh Dashboard**:
 | 
				
			||||||
    -   A flexible visualization tool based on OpenSearch Dashboards (or historically Kibana).
 | 
					    -   A flexible visualization tool based on OpenSearch Dashboards (or historically Kibana).
 | 
				
			||||||
 
 | 
				
			|||||||
@@ -1,6 +1,6 @@
 | 
				
			|||||||
# Reference Manual - Introduction
 | 
					# Reference Manual - Introduction
 | 
				
			||||||
 | 
					
 | 
				
			||||||
Welcome to the Reference Manual for Wazuh-Docker, version 4.12.2. This manual provides comprehensive information about deploying, configuring, and managing your Wazuh environment using Docker.
 | 
					Welcome to the Reference Manual for Wazuh-Docker, version 4.13.0. This manual provides comprehensive information about deploying, configuring, and managing your Wazuh environment using Docker.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
## Purpose of This Manual
 | 
					## Purpose of This Manual
 | 
				
			||||||
 | 
					
 | 
				
			||||||
@@ -44,4 +44,4 @@ This manual is structured to help you find information efficiently:
 | 
				
			|||||||
-   If you need to customize your deployment, refer to the [Configuration](configuration/configuration.md) section.
 | 
					-   If you need to customize your deployment, refer to the [Configuration](configuration/configuration.md) section.
 | 
				
			||||||
-   For specific terms or concepts, consult the [Glossary](glossary.md).
 | 
					-   For specific terms or concepts, consult the [Glossary](glossary.md).
 | 
				
			||||||
 | 
					
 | 
				
			||||||
This manual refers to version 4.12.2 of Wazuh-Docker. Ensure you are using the documentation that corresponds to your deployed version.
 | 
					This manual refers to version 4.13.0 of Wazuh-Docker. Ensure you are using the documentation that corresponds to your deployed version.
 | 
				
			||||||
 
 | 
				
			|||||||
@@ -29,4 +29,4 @@
 | 
				
			|||||||
        ```
 | 
					        ```
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					
 | 
				
			||||||
Consult the official Wazuh documentation for version 4.12.2 for detailed information on all possible configuration parameters for each component.
 | 
					Consult the official Wazuh documentation for version 4.13.0 for detailed information on all possible configuration parameters for each component.
 | 
				
			||||||
@@ -1,6 +1,6 @@
 | 
				
			|||||||
# Reference Manual - Configuration
 | 
					# Reference Manual - Configuration
 | 
				
			||||||
 | 
					
 | 
				
			||||||
This section details how to configure your Wazuh-Docker deployment (version 4.12.2). Proper configuration is key to tailoring the Wazuh stack to your specific needs, managing data persistence, and integrating with your environment.
 | 
					This section details how to configure your Wazuh-Docker deployment (version 4.13.0). Proper configuration is key to tailoring the Wazuh stack to your specific needs, managing data persistence, and integrating with your environment.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
## Overview of Configuration Methods
 | 
					## Overview of Configuration Methods
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 
 | 
				
			|||||||
@@ -1,6 +1,6 @@
 | 
				
			|||||||
# Reference Manual - Deployment
 | 
					# Reference Manual - Deployment
 | 
				
			||||||
 | 
					
 | 
				
			||||||
This section provides detailed instructions for deploying Wazuh-Docker (version 4.12.2) in various configurations. Choose the deployment model that best suits your needs, from simple single-node setups for testing to more robust multi-node configurations for production environments.
 | 
					This section provides detailed instructions for deploying Wazuh-Docker (version 4.13.0) in various configurations. Choose the deployment model that best suits your needs, from simple single-node setups for testing to more robust multi-node configurations for production environments.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
## Overview of Deployment Options
 | 
					## Overview of Deployment Options
 | 
				
			||||||
 | 
					
 | 
				
			||||||
@@ -24,11 +24,11 @@ Ensure you have:
 | 
				
			|||||||
 | 
					
 | 
				
			||||||
-   Met all the [System Requirements](ref/getting-started/requirements.md).
 | 
					-   Met all the [System Requirements](ref/getting-started/requirements.md).
 | 
				
			||||||
-   Installed Docker and Docker Compose on your host(s).
 | 
					-   Installed Docker and Docker Compose on your host(s).
 | 
				
			||||||
-   Cloned the `wazuh-docker` repository (version `4.12.2`) or downloaded the necessary deployment files.
 | 
					-   Cloned the `wazuh-docker` repository (version `4.13.0`) or downloaded the necessary deployment files.
 | 
				
			||||||
    ```bash
 | 
					    ```bash
 | 
				
			||||||
    git clone [https://github.com/wazuh/wazuh-docker.git](https://github.com/wazuh/wazuh-docker.git)
 | 
					    git clone [https://github.com/wazuh/wazuh-docker.git](https://github.com/wazuh/wazuh-docker.git)
 | 
				
			||||||
    cd wazuh-docker
 | 
					    cd wazuh-docker
 | 
				
			||||||
    git checkout v4.12.2
 | 
					    git checkout v4.13.0
 | 
				
			||||||
    ```
 | 
					    ```
 | 
				
			||||||
-   Made a backup of any existing Wazuh data if you are migrating or upgrading.
 | 
					-   Made a backup of any existing Wazuh data if you are migrating or upgrading.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 
 | 
				
			|||||||
@@ -1,6 +1,6 @@
 | 
				
			|||||||
# Reference Manual - Getting Started
 | 
					# Reference Manual - Getting Started
 | 
				
			||||||
 | 
					
 | 
				
			||||||
This section guides you through the initial steps to get your Wazuh-docker (version 4.12.2) environment up and running. We will cover the prerequisites and point you to the deployment instructions.
 | 
					This section guides you through the initial steps to get your Wazuh-docker (version 4.13.0) environment up and running. We will cover the prerequisites and point you to the deployment instructions.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
## Overview
 | 
					## Overview
 | 
				
			||||||
 | 
					
 | 
				
			||||||
@@ -27,11 +27,11 @@ Before diving into the deployment, please ensure you have reviewed:
 | 
				
			|||||||
    Verify that your host system has sufficient RAM, CPU, and disk space. Ensure Docker and Docker Compose are installed and functioning correctly.
 | 
					    Verify that your host system has sufficient RAM, CPU, and disk space. Ensure Docker and Docker Compose are installed and functioning correctly.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
2.  **Obtain Wazuh-docker Configuration**:
 | 
					2.  **Obtain Wazuh-docker Configuration**:
 | 
				
			||||||
    You'll need the Docker Compose files and any associated configuration files from the `wazuh-docker` repository for version 4.12.2.
 | 
					    You'll need the Docker Compose files and any associated configuration files from the `wazuh-docker` repository for version 4.13.0.
 | 
				
			||||||
    ```bash
 | 
					    ```bash
 | 
				
			||||||
    git clone [https://github.com/wazuh/wazuh-docker.git](https://github.com/wazuh/wazuh-docker.git)
 | 
					    git clone [https://github.com/wazuh/wazuh-docker.git](https://github.com/wazuh/wazuh-docker.git)
 | 
				
			||||||
    cd wazuh-docker
 | 
					    cd wazuh-docker
 | 
				
			||||||
    git checkout v4.12.2
 | 
					    git checkout v4.13.0
 | 
				
			||||||
    # Navigate to the specific docker-compose directory, e.g., single-node or multi-node
 | 
					    # Navigate to the specific docker-compose directory, e.g., single-node or multi-node
 | 
				
			||||||
    # cd docker-compose/single-node/ (example path)
 | 
					    # cd docker-compose/single-node/ (example path)
 | 
				
			||||||
    ```
 | 
					    ```
 | 
				
			||||||
 
 | 
				
			|||||||
@@ -1,6 +1,6 @@
 | 
				
			|||||||
# Reference Manual - Requirements
 | 
					# Reference Manual - Requirements
 | 
				
			||||||
 | 
					
 | 
				
			||||||
Before deploying Wazuh-Docker (version 4.12.2), it's essential to ensure your environment meets the necessary hardware and software requirements. Meeting these prerequisites will help ensure a stable and performant Wazuh deployment.
 | 
					Before deploying Wazuh-Docker (version 4.13.0), it's essential to ensure your environment meets the necessary hardware and software requirements. Meeting these prerequisites will help ensure a stable and performant Wazuh deployment.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
## Host System Requirements
 | 
					## Host System Requirements
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 
 | 
				
			|||||||
@@ -1,6 +1,6 @@
 | 
				
			|||||||
# Reference Manual - Glossary
 | 
					# Reference Manual - Glossary
 | 
				
			||||||
 | 
					
 | 
				
			||||||
This glossary defines key terms and concepts related to Wazuh, Docker, and their use together in the Wazuh-Docker project (version 4.12.2).
 | 
					This glossary defines key terms and concepts related to Wazuh, Docker, and their use together in the Wazuh-Docker project (version 4.13.0).
 | 
				
			||||||
 | 
					
 | 
				
			||||||
---
 | 
					---
 | 
				
			||||||
 | 
					
 | 
				
			||||||
@@ -22,7 +22,7 @@ This glossary defines key terms and concepts related to Wazuh, Docker, and their
 | 
				
			|||||||
 | 
					
 | 
				
			||||||
**D**
 | 
					**D**
 | 
				
			||||||
 | 
					
 | 
				
			||||||
-   **Dashboard (Wazuh Dashboard / OpenSearch Dashboards / Kibana)**: A web-based visualization tool used to explore, analyze, and visualize data stored in the Wazuh Indexer. It provides dashboards, visualizations, and a query interface for security events and alerts. For Wazuh 4.12.2, this is typically OpenSearch Dashboards.
 | 
					-   **Dashboard (Wazuh Dashboard / OpenSearch Dashboards / Kibana)**: A web-based visualization tool used to explore, analyze, and visualize data stored in the Wazuh Indexer. It provides dashboards, visualizations, and a query interface for security events and alerts. For Wazuh 4.13.0, this is typically OpenSearch Dashboards.
 | 
				
			||||||
-   **Decoder**: A component in the Wazuh Manager that parses and extracts relevant information (fields) from raw log messages or event data.
 | 
					-   **Decoder**: A component in the Wazuh Manager that parses and extracts relevant information (fields) from raw log messages or event data.
 | 
				
			||||||
-   **Docker**: An open platform for developing, shipping, and running applications inside containers.
 | 
					-   **Docker**: An open platform for developing, shipping, and running applications inside containers.
 | 
				
			||||||
-   **Docker Compose**: A tool for defining and running multi-container Docker applications. It uses a YAML file (`docker-compose.yml`) to configure the application's services, networks, and volumes.
 | 
					-   **Docker Compose**: A tool for defining and running multi-container Docker applications. It uses a YAML file (`docker-compose.yml`) to configure the application's services, networks, and volumes.
 | 
				
			||||||
@@ -42,7 +42,7 @@ This glossary defines key terms and concepts related to Wazuh, Docker, and their
 | 
				
			|||||||
 | 
					
 | 
				
			||||||
**I**
 | 
					**I**
 | 
				
			||||||
 | 
					
 | 
				
			||||||
-   **Indexer (Wazuh Indexer / OpenSearch / Elasticsearch)**: The component responsible for storing, indexing, and making searchable the alerts and event data generated by the Wazuh Manager. For Wazuh 4.12.2, this is typically OpenSearch.
 | 
					-   **Indexer (Wazuh Indexer / OpenSearch / Elasticsearch)**: The component responsible for storing, indexing, and making searchable the alerts and event data generated by the Wazuh Manager. For Wazuh 4.13.0, this is typically OpenSearch.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
**L**
 | 
					**L**
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 
 | 
				
			|||||||
@@ -3,7 +3,7 @@ version: '3.7'
 | 
				
			|||||||
 | 
					
 | 
				
			||||||
services:
 | 
					services:
 | 
				
			||||||
  wazuh.agent:
 | 
					  wazuh.agent:
 | 
				
			||||||
    image: wazuh/wazuh-agent:4.12.1
 | 
					    image: wazuh/wazuh-agent:4.13.0
 | 
				
			||||||
    restart: always
 | 
					    restart: always
 | 
				
			||||||
    environment:
 | 
					    environment:
 | 
				
			||||||
      - WAZUH_MANAGER_SERVER=<WAZUH_MANAGER_IP>
 | 
					      - WAZUH_MANAGER_SERVER=<WAZUH_MANAGER_IP>
 | 
				
			||||||
 
 | 
				
			|||||||
		Reference in New Issue
	
	Block a user