{WiP} Update the installation guide

javimed · javimed · commit fdb9106aaae7 · 2025-09-24T17:15:26.000-03:00
diff --git a/source/installation-guide/wazuh-agent/index.rst b/source/installation-guide/wazuh-agent/index.rst
@@ -8,9 +8,9 @@
 Wazuh agent
 ===========
 
-The Wazuh agent is multi-platform and runs on the endpoints that the user wants to monitor. It communicates with the Wazuh server, sending data in near real-time through an encrypted and authenticated channel.
+The Wazuh agent is multi-platform and runs on the endpoints that you want to monitor. It communicates with the Wazuh server, sending data in near real-time through an encrypted and authenticated channel.
 
-The agent was developed considering the need to monitor a wide variety of different endpoints without impacting their performance. It is supported on the most popular operating systems, and it requires 35 MB of RAM on average.
+The Wazuh agent was developed considering the need to monitor a wide variety of different endpoints without impacting their performance. It is supported on the most popular operating systems, and it requires 35 MB of RAM on average.
 
 The Wazuh agent provides :ref:`key features <agents_modules>` to enhance your system’s security.
 
@@ -120,7 +120,7 @@ You can also deploy a new agent following the instructions in the Wazuh dashboar
     :title: Deploy new agent button
     :alt: Deploy new agent button
 
-Then the Wazuh dashboard will show you the steps to deploy a new agent.
+Then follow the steps on the Wazuh dashboard to deploy a new agent.
 
   .. thumbnail::  /images/installation/deploy-new-agent-from-ui-options.png
     :align: center
diff --git a/source/installation-guide/wazuh-agent/wazuh-agent-package-aix.rst b/source/installation-guide/wazuh-agent/wazuh-agent-package-aix.rst
@@ -10,16 +10,13 @@ Deploying Wazuh agents on AIX endpoints
 
    Support for AIX systems ends in Wazuh 5.0.0.
 
-The agent runs on the endpoint you want to monitor and communicates with the Wazuh server, sending data in near real-time through an encrypted and authenticated channel.
+The Wazuh agent runs on the endpoint you want to monitor and communicates with the Wazuh manager, sending data in near real-time through an encrypted and authenticated channel.
 
-The deployment of a Wazuh agent on an AIX system uses deployment variables that facilitate the task of installing, registering, and configuring the agent.
+The deployment of a Wazuh agent on an AIX system uses deployment variables that facilitate the task of installing, enrolling, and configuring the Wazuh agent.
 
 .. note::
 
-   You need root user privileges to run all the commands described below.
-
-   Required dependencies:
-      * bash
+   You need root user privileges and Bash to run all the commands described below.
 
 #. To start the deployment process, download the `AIX installer <https://packages.wazuh.com/|WAZUH_CURRENT_MAJOR_AIX|/aix/wazuh-agent-|WAZUH_CURRENT_AIX|-|WAZUH_REVISION_AIX|.aix.ppc.rpm>`_.
 
diff --git a/source/installation-guide/wazuh-agent/wazuh-agent-package-hpux.rst b/source/installation-guide/wazuh-agent/wazuh-agent-package-hpux.rst
@@ -10,7 +10,7 @@ Installing Wazuh agents on HP-UX endpoints
 
    Support for HP-UX systems ends in Wazuh 5.0.0.
 
-The installed agent runs on the endpoint you want to monitor and communicates with the Wazuh server, sending data in near real-time through an encrypted and authenticated channel.
+The installed agent runs on the endpoint you want to monitor and communicates with the Wazuh manager, sending data in near real-time through an encrypted and authenticated channel.
 
 .. note:: You need root user privileges to run all the commands described below.
 
diff --git a/source/installation-guide/wazuh-agent/wazuh-agent-package-linux.rst b/source/installation-guide/wazuh-agent/wazuh-agent-package-linux.rst
@@ -10,9 +10,9 @@ Deploying Wazuh agents on Linux endpoints
 
    Support for Red Hat 5, CentOS 5, Oracle Linux 5, and SUSE Linux Enterprise Server 11 systems ends in Wazuh 5.0.0.
 
-The agent runs on the host you want to monitor and communicates with the Wazuh server, sending data in near real-time through an encrypted and authenticated channel.
+The Wazuh agent runs on the endpoint you want to monitor and communicates with the Wazuh manager, sending data in near real-time through an encrypted and authenticated channel.
 
-The deployment of a Wazuh agent on a Linux system uses deployment variables that facilitate the task of installing, registering, and configuring the agent. Alternatively, if you want to download the Wazuh agent package directly, see the :doc:`packages list </installation-guide/packages-list>` section.
+The deployment of a Wazuh agent on a Linux endpoint uses deployment variables that facilitate the task of installing, enrolling, and configuring the Wazuh agent. Alternatively, if you want to download the Wazuh agent package directly, see the :doc:`packages list </installation-guide/packages-list>` section.
 
 .. note:: You need root user privileges to run all the commands described below.
 
diff --git a/source/installation-guide/wazuh-agent/wazuh-agent-package-macos.rst b/source/installation-guide/wazuh-agent/wazuh-agent-package-macos.rst
@@ -6,7 +6,7 @@
 Installing Wazuh agents on macOS endpoints
 ==========================================
 
-The agent runs on the endpoint you want to monitor and communicates with the Wazuh server, sending data in near real-time through an encrypted and authenticated.
+The Wazuh agent runs on the endpoint you want to monitor and communicates with the Wazuh manager, sending data in near real-time through an encrypted and authenticated channel.
 
 .. note:: You need root user privileges to run all the commands described below.
 
diff --git a/source/installation-guide/wazuh-agent/wazuh-agent-package-solaris.rst b/source/installation-guide/wazuh-agent/wazuh-agent-package-solaris.rst
@@ -10,7 +10,7 @@ Installing Wazuh agents on Solaris endpoints
 
    Support for Solaris systems ends in Wazuh 5.0.0.
 
-The agent runs on the host you want to monitor and communicates with the Wazuh manager, sending data in near real-time through an encrypted and authenticated channel.
+The Wazuh agent runs on the endpoint you want to monitor and communicates with the Wazuh manager, sending data in near real-time through an encrypted and authenticated channel.
 
 To start the installation process, select your architecture: i386 or SPARC.
 
diff --git a/source/installation-guide/wazuh-agent/wazuh-agent-package-windows.rst b/source/installation-guide/wazuh-agent/wazuh-agent-package-windows.rst
@@ -10,9 +10,9 @@ Installing Wazuh agents on Windows endpoints
 
    Support for Windows XP, Windows Vista, and Windows Server 2003 systems ends in Wazuh 5.0.0.
 
-The agent runs on the endpoint you want to monitor and communicates with the Wazuh server, sending data in near real-time through an encrypted and authenticated channel. Monitor your Windows systems with Wazuh, from Windows XP to the latest available versions including Windows 11 and Windows Server 2022.
+The Wazuh agent runs on the endpoint you want to monitor and communicates with the Wazuh manager, sending data in near real-time through an encrypted and authenticated channel. You can deploy the Wazuh agent on Windows systems ranging from Windows XP to the latest versions, including Windows 11 and Windows Server 2022.
 
-.. note:: To perform the installation, administrator privileges are required.
+.. note:: You must have administrator privileges to perform the installation.
 
 #. To start the installation process, download the `Windows installer <https://packages.wazuh.com/|WAZUH_CURRENT_MAJOR_WINDOWS|/windows/wazuh-agent-|WAZUH_CURRENT_WINDOWS|-|WAZUH_REVISION_WINDOWS|.msi>`_. 
 
diff --git a/source/installation-guide/wazuh-dashboard/index.rst b/source/installation-guide/wazuh-dashboard/index.rst
@@ -6,17 +6,16 @@
 Wazuh dashboard
 ===============
 
-This central component is a flexible and intuitive web interface for mining, analyzing, and visualizing security data. It provides out-of-the-box dashboards, allowing you to seamlessly navigate through the user interface. 
+This Wazuh central component is a flexible and intuitive web interface for mining, analyzing, and visualizing security data. It provides out-of-the-box dashboards, allowing you to seamlessly navigate through the user interface.
 
-With the Wazuh dashboard, users can visualize security events, detected vulnerabilities, file integrity monitoring data, configuration assessment results, cloud infrastructure monitoring events, and regulatory compliance standards. If you want to learn more about the Wazuh components, see the :doc:`Getting started <../../getting-started/components/index>` section.
+With the Wazuh dashboard, you can visualize security events, detected vulnerabilities, file integrity monitoring data, configuration assessment results, cloud infrastructure monitoring events, and regulatory compliance standards. If you want to learn more about the Wazuh components, see the :doc:`Getting started <../../getting-started/components/index>` section.
 
 Check the requirements below and choose an installation method to start installing the Wazuh dashboard.
 
 - :doc:`Assisted installation <installation-assistant>`: Install this component by running an assistant that automates the installation and configuration process. 
 
 - :doc:`Step-by-step installation <step-by-step>`: Install this component following detailed step-by-step instructions.
 
-
 .. raw:: html
 
   <div class="link-boxes-group layout-3" data-step="3">
diff --git a/source/installation-guide/wazuh-dashboard/installation-assistant.rst b/source/installation-guide/wazuh-dashboard/installation-assistant.rst
@@ -17,17 +17,17 @@ Wazuh dashboard installation
 
       # curl -sO https://packages.wazuh.com/|WAZUH_CURRENT_MINOR|/wazuh-install.sh
 
-#. Run the Wazuh installation assistant with the option ``--wazuh-dashboard`` and the node name to install and configure the Wazuh dashboard. The node name must be the same one used in ``config.yml`` for the initial configuration, for example, ``dashboard``.
+#. Run the Wazuh installation assistant with the option ``--wazuh-dashboard`` and the node name to install and configure the Wazuh dashboard. The node name must be the same one used in ``config.yml`` for the initial configuration, for example, ``dashboard``:
    
    .. note::
       
-      Make sure that a copy of the ``wazuh-install-files.tar`` file, created during the initial configuration step, is placed in your working directory.
+      Make sure that a copy of ``wazuh-install-files.tar`` created during the Wazuh indexer installation is placed in your working directory.
 
    .. code-block:: console
 
       # bash wazuh-install.sh --wazuh-dashboard dashboard
 
-   The default Wazuh web user interface port is 443, used by the Wazuh dashboard. You can change this port using the optional parameter ``-p|--port <PORT_NUMBER>``. Some recommended ports are 8443, 8444, 8080, 8888, and 9000.
+   The default Wazuh web user interface port is 443, used by the Wazuh dashboard. You can change this port using the optional parameter ``-p <PORT_NUMBER>`` or ``--port <PORT_NUMBER>``. Some recommended ports are 8443, 8444, 8080, 8888, and 9000.
 
    Once the Wazuh installation is completed, the output shows the access credentials and a message that confirms that the installation was successful.
 
diff --git a/source/installation-guide/wazuh-dashboard/step-by-step.rst b/source/installation-guide/wazuh-dashboard/step-by-step.rst
@@ -15,6 +15,8 @@ Install and configure the Wazuh dashboard following step-by-step instructions. T
 Wazuh dashboard installation
 ----------------------------
 
+Follow these steps to install the Wazuh dashboard.
+
 Installing package dependencies
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
diff --git a/source/installation-guide/wazuh-indexer/step-by-step.rst b/source/installation-guide/wazuh-indexer/step-by-step.rst
@@ -12,7 +12,7 @@ The installation process is divided into three stages.
 
 #. Certificates creation
 
-#. Nodes installation
+#. Wazuh indexer nodes installation
 
 #. Cluster initialization
 
diff --git a/source/installation-guide/wazuh-server/index.rst b/source/installation-guide/wazuh-server/index.rst
@@ -6,9 +6,9 @@
 Wazuh server
 ============
 
-The Wazuh server analyzes the data received from the Wazuh agents, triggering alerts when threats or anomalies are detected. It is also used to remotely manage the agents' configuration and monitor their status. If you want to learn more about the Wazuh components, check the :doc:`Getting started <../../getting-started/components/index>` section.
+The Wazuh server analyzes the data received from the Wazuh agents, triggering alerts when threats or anomalies are detected. It is also used to remotely manage the configurations of Wazuh agents and monitor their status. If you want to learn more about the Wazuh components, check the :doc:`Getting started <../../getting-started/components/index>` section.
 
-You can install the Wazuh server on a single host. Alternatively, you can install it distributed in multiple nodes in a cluster configuration. Multi-node configurations provide high availability and improved performance. And if combined with a network load balancer an efficient use of its capacity can be achieved. 
+You can install the Wazuh server on a single host or distribute it across multiple nodes in a cluster configuration. Multi-node configurations provide high availability and improved performance. When combined with a network load balancer, you can achieve efficient use of its capacity.
 
 Check the requirements below and choose an installation method to start installing the Wazuh server.
 
@@ -81,7 +81,7 @@ The Wazuh server requires a 64-bit Intel, AMD, or ARM Linux processor (x86_64/AM
 Hardware requirements
 ^^^^^^^^^^^^^^^^^^^^^
 
-The Wazuh server can be installed as a single-node or as a multi-node cluster.
+You can install the Wazuh server as a single-node or multi-node cluster.
 
 - Hardware recommendations
                           
@@ -122,9 +122,7 @@ To determine if a Wazuh server requires more resources, monitor these files:
 - ``/var/ossec/var/run/wazuh-remoted.state``: the variable ``discarded_count`` indicates if messages from the agents were discarded.
 
 
-These two variables should be zero if the environment is working properly. If it is not the case, additional nodes can be added to the cluster. 
-
-
+These two variables should be zero if the environment is working properly. If it is not the case, you can add additional nodes to the cluster.
 
 .. toctree::
     :hidden:
diff --git a/source/installation-guide/wazuh-server/installation-assistant.rst b/source/installation-guide/wazuh-server/installation-assistant.rst
@@ -6,20 +6,20 @@
 Installing the Wazuh server using the assisted installation method
 ==================================================================
 
-Install the Wazuh server as a single-node or multi-node cluster on a 64-bit (x86_64/AMD64 or AARCH64/ARM64) architecture using the assisted installation method. The Wazuh server analyzes the data received from the agents, triggering alerts when it detects threats and anomalies. This central component includes the Wazuh manager and Filebeat.
+Install the Wazuh server as a single-node or multi-node cluster on a 64-bit (x86_64/AMD64 or AARCH64/ARM64) architecture using the assisted installation method. The Wazuh server analyzes the data received from the Wazuh agents, triggering alerts when it detects threats and anomalies. This central component includes the Wazuh manager and Filebeat.
 
 Wazuh server cluster installation
 ---------------------------------
 
-#. Download the Wazuh installation assistant.
+#. Download the Wazuh installation assistant. Skip this step if you installed Wazuh indexer on the same server and the Wazuh installation assistant is already in your working directory:
 
    .. code-block:: console
    
        # curl -sO https://packages.wazuh.com/|WAZUH_CURRENT_MINOR|/wazuh-install.sh
 
-#. Run the Wazuh installation assistant with the option ``--wazuh-server`` followed by the node name to install the Wazuh server. The node name must be the same one used in ``config.yml`` for the initial configuration, for example, ``wazuh-1``.
+#. Run the Wazuh installation assistant with the option ``--wazuh-server`` followed by the node name to install the Wazuh server. The node name must be the same one used in config.yml for the initial configuration, for example, ``wazuh-1``:
  
-   .. note:: Make sure that a copy of the ``wazuh-install-files.tar``, created during the initial configuration step, is placed in your working directory.
+   .. note:: Make sure that a copy of ``wazuh-install-files.tar``, created during the initial configuration step, is placed in your working directory.
 
    .. code-block:: console
   
