{WiP} Update the installation guide

Author: javimed

source/_templates/installations/disable-wazuh-updates.rst

@@ -1,32 +1,28 @@
 .. Copyright (C) 2015, Wazuh, Inc.
 
-.. note::
+We recommend disabling the Wazuh package repositories after installing all components on this server to prevent accidental upgrades.
 
-   **Recommended Action**: Disable Wazuh Updates.
+Execute the following command only after completing all installations:
 
-   We recommend disabling the Wazuh package repositories after installing all components on this server to prevent accidental upgrades.
+.. tabs::
 
-   Execute the following command only after completing all installations:
+   .. group-tab:: APT
 
-   .. tabs::
+      .. code-block:: console
 
-      .. group-tab:: APT
+         # sed -i "s/^deb /#deb /" /etc/apt/sources.list.d/wazuh.list
+         # apt update
 
-         .. code-block:: console
+   .. group-tab:: YUM
 
-            # sed -i "s/^deb /#deb /" /etc/apt/sources.list.d/wazuh.list
-            # apt update
+      .. code-block:: console
 
-      .. group-tab:: YUM
+         # sed -i "s/^enabled=1/enabled=0/" /etc/yum.repos.d/wazuh.repo
 
-         .. code-block:: console
+   .. group-tab:: DNF
 
-            # sed -i "s/^enabled=1/enabled=0/" /etc/yum.repos.d/wazuh.repo
+      .. code-block:: console
 
-      .. group-tab:: DNF
-
-         .. code-block:: console
-
-            # sed -i "s/^enabled=1/enabled=0/" /etc/yum.repos.d/wazuh.repo
+         # sed -i "s/^enabled=1/enabled=0/" /etc/yum.repos.d/wazuh.repo
 
 .. End of include file

source/_templates/installations/wazuh/recommended-operating-systems.rst

@@ -1,7 +1,6 @@
 .. Copyright (C) 2015, Wazuh, Inc.
 
 -  Amazon Linux 2, Amazon Linux 2023
--  CentOS 7, 8
 -  CentOS Stream 10
 -  Red Hat Enterprise Linux 7, 8, 9, 10
 -  Ubuntu 16.04, 18.04, 20.04, 22.04, 24.04

source/installation-guide/index.rst

@@ -2,30 +2,30 @@
 
 .. meta::
   :description: Visit the Wazuh installation guide and learn more about the deployment process, available installation alternatives, and requirements.
-  
+
 .. _installation_guide:
 
 
 Installation guide
 ==================
 
-Wazuh is a security platform that provides unified XDR and SIEM protection for endpoints and cloud workloads. The solution is composed of a single universal agent and three central components: the Wazuh server, the Wazuh indexer, and the Wazuh dashboard. For more information, check the :doc:`Getting Started </getting-started/index>` documentation. 
+Wazuh is a security platform that provides unified XDR and SIEM protection for endpoints and cloud workloads. The solution is composed of the :doc:`Wazuh agent </getting-started/components/wazuh-agent>` and three central components: the :doc:`Wazuh server </getting-started/components/wazuh-server>`, the :doc:`Wazuh indexer </getting-started/components/wazuh-indexer>`, and the :doc:`Wazuh dashboard </getting-started/components/wazuh-dashboard>`. For more information, check the :doc:`Getting Started </getting-started/index>` documentation.
 
-Wazuh is free and open source. Its components abide by the `GNU General Public License, version 2 <https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html>`_, and the `Apache License, Version 2.0 <https://www.apache.org/licenses/LICENSE-2.0>`_ (ALv2). 
+Wazuh is free and open source. Its components abide by the `GNU General Public License, version 2 <https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html>`_, and the `Apache License, Version 2.0 <https://www.apache.org/licenses/LICENSE-2.0>`_ (ALv2).
 
-In this installation guide, you will learn how to install Wazuh in your infrastructure. We also offer `Wazuh Cloud <https://wazuh.com/cloud/>`_, our software as a service (SaaS) solution. Wazuh cloud is ready to use, with no additional hardware or software required, driving down the cost and complexity. Check the :doc:`Cloud service </cloud-service/index>` documentation for more information and take advantage of the `Cloud trial <https://console.cloud.wazuh.com/sign-up?landing=trial>`_ to explore this service.
+In this installation guide, you will learn how to install Wazuh in your infrastructure. We also offer `Wazuh Cloud <https://wazuh.com/cloud/>`_, our software as a service (SaaS) solution. Wazuh Cloud is ready to use, with no additional hardware or software required, reducing the cost and complexity. Check the :doc:`Wazuh Cloud service </cloud-service/index>` documentation for more information and take advantage of the `Wazuh Cloud trial <https://console.cloud.wazuh.com/sign-up?landing=trial>`_ to explore this service.
 
 
 Installing the Wazuh central components
 ---------------------------------------
 
-The Wazuh indexer and Wazuh server can be installed on a single host or be distributed in cluster configurations. You can choose between two installation methods for each Wazuh central component. Both options provide instructions to install the central components on a single host or on separate hosts.
+You can install the Wazuh indexer, Wazuh server, and Wazuh dashboard on a single host or distribute them in cluster configurations. Each Wazuh central component supports two installation methods and both methods provide instructions to install the central components on a single host or on separate hosts.
 
 You can check our :doc:`Quickstart </quickstart>` documentation to perform an all-in-one installation. This is the fastest way to get the Wazuh central components up and running.
 
-For more deployment flexibility and customization, install the Wazuh central components by starting with the :doc:`Wazuh indexer <wazuh-indexer/index>` deployment. This deployment method allows the all-in-one installation, and the installation of the components on separate servers.
+For more deployment flexibility and customization, install the Wazuh central components by starting with the :doc:`Wazuh indexer <wazuh-indexer/index>` deployment. This deployment method supports both an all-in-one installation and installing components on separate hosts.
 
-This is the installation workflow you will follow:
+Follow this installation workflow:
 
 .. raw:: html
 
@@ -47,7 +47,7 @@ This is the installation workflow you will follow:
 
       </a>
     </div>
-  
+
     <div class="link-boxes-item future-step">
       <a class="link-boxes-link" href="wazuh-server/index.html">
         <p class="link-boxes-label">Install the Wazuh server</p>
@@ -60,15 +60,15 @@ This is the installation workflow you will follow:
 
       </a>
     </div>
-  
+
     <div class="link-boxes-item future-step">
       <a class="link-boxes-link" href="wazuh-dashboard/index.html">
         <p class="link-boxes-label">Install the Wazuh dashboard</p>
 
 .. image:: ../images/installation/Dashboard-noBG.png
      :align: center
      :height: 61px
-     
+
 .. raw:: html
 
       </a>
@@ -80,9 +80,9 @@ This is the installation workflow you will follow:
 Installing the Wazuh agent
 --------------------------
 
-The Wazuh agent is a single and lightweight monitoring software. It is a multi-platform component that can be deployed to laptops, desktops, servers, cloud instances, containers, or virtual machines. It provides visibility into the endpoint's security by collecting critical system and application records, inventory data, and detecting anomalies. 
+The Wazuh agent is a single, lightweight monitoring software. It is a multi-platform component that you can deploy to laptops, desktops, servers, cloud instances, containers, or virtual machines. It provides visibility into the monitored endpoint by collecting critical system and application records, inventory data, and detecting potential anomalies.
 
-If the Wazuh central components are already installed in your environment, select your operating system below and follow the installation steps to deploy the agent on the endpoints. 
+Select your endpoint operating system below and follow the installation steps to deploy the Wazuh agent.
 
 .. warning::
 
@@ -160,21 +160,23 @@ If the Wazuh central components are already installed in your environment, selec
     </div>
   </div>
 
-
-
 Packages list
 -------------
 
-In the :doc:`Packages list </installation-guide/packages-list>` section, you will find all the packages required for the installation of Wazuh.
+The :doc:`Packages list <packages-list>` section contains all the packages required for installing Wazuh.
+
+Uninstalling Wazuh
+------------------
+
+In the :doc:`Uninstalling Wazuh <uninstalling-wazuh/index>` section, you will find instructions on how to uninstall the Wazuh central components and the Wazuh agent.
 
-Other installation alternatives
--------------------------------
+Installation alternatives
+-------------------------
 
-Wazuh provides other :doc:`installation alternatives </deployment-options/index>`. These are complementary to the installation methods of this installation guide. You will find instructions on how to deploy Wazuh using ready-to-use machines, containers, and orchestration tools. There is also information on how to install the solution offline, from sources, and with commercial options.
+Wazuh provides other :doc:`installation alternatives </deployment-options/index>` as well. These are complementary to the installation methods of this installation guide. You will find instructions on how to deploy Wazuh using ready-to-use machines, containers, and orchestration tools. There is also information on how to install the solution offline, from sources, and with alternative components.
 
 
 .. toctree::
-   :hidden:
    :maxdepth: 1
 
    wazuh-indexer/index

source/installation-guide/wazuh-dashboard/installation-assistant.rst

@@ -55,6 +55,9 @@ Wazuh dashboard installation
 
    When you access the Wazuh dashboard for the first time, the browser shows a warning message stating that the certificate was not issued by a trusted authority. An exception can be added in the advanced options of the web browser. For increased security, the ``root-ca.pem`` file previously generated can be imported to the certificate manager of the browser instead. Alternatively, a certificate from a trusted authority can be configured. 
 
+Disable Wazuh updates
+---------------------
+
 .. include:: /_templates/installations/disable-wazuh-updates.rst
 
 Next steps

source/installation-guide/wazuh-dashboard/step-by-step.rst

@@ -124,6 +124,9 @@ Starting the Wazuh dashboard service
 
    When you access the Wazuh dashboard for the first time, the browser shows a warning message stating that the certificate was not issued by a trusted authority. An exception can be added in the advanced options of the web browser. For increased security, the ``root-ca.pem``  file previously generated can be imported to the certificate manager of the browser. Alternatively, a certificate from a trusted authority can be configured.
 
+Disable Wazuh updates
+---------------------
+
 .. include:: /_templates/installations/disable-wazuh-updates.rst
 
 Securing your Wazuh installation

source/installation-guide/wazuh-indexer/index.rst

@@ -7,63 +7,63 @@ Wazuh indexer
 =============
 
 
-The Wazuh indexer is a highly scalable, full-text search and analytics engine. This Wazuh central component indexes and stores alerts generated by the Wazuh server and provides near real-time data search and analytics capabilities. If you want to learn more about the Wazuh components, check the :doc:`Getting started <../../getting-started/components/index>` section.
+The Wazuh indexer is a highly scalable, full-text search and analytics engine. It indexes and stores alerts generated by the Wazuh server and provides near real-time data search and analytics capabilities. If you want to learn more about Wazuh components, check the :doc:`Getting started <../../getting-started/components/index>` section.
 
-You can install the Wazuh indexer on a single host. Alternatively, you can install it distributed in multiple nodes, in a cluster configuration. This provides scalability, high availability, and improved performance. 
+You can install the Wazuh indexer on a single host or distribute it across multiple nodes in a cluster configuration. The cluster configuration provides scalability, high availability, and improved performance.
 
 Check the requirements below and choose an installation method to start installing the Wazuh indexer.
 
-- :doc:`Assisted installation <installation-assistant>`: Install this component by running an assistant that automates the installation and configuration process.
+-  :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.
+-  :doc:`Step-by-step installation <step-by-step>`: Install this component by following detailed step-by-step instructions.
 
 .. raw:: html
 
-  <div class="link-boxes-group layout-3" data-step="1">
-    <div class="steps-line">
-      <div class="steps-number current-step">1</div>
-      <div class="steps-number future-step">2</div>
-      <div class="steps-number future-step">3</div>
-    </div>
-    <div class="link-boxes-item current-step">
-      <div class="link-boxes-link" href="#">
-        <p class="link-boxes-label">Install the Wazuh indexer</p>
+   <div class="link-boxes-group layout-3" data-step="1">
+     <div class="steps-line">
+       <div class="steps-number current-step">1</div>
+       <div class="steps-number future-step">2</div>
+       <div class="steps-number future-step">3</div>
+     </div>
+     <div class="link-boxes-item current-step">
+       <div class="link-boxes-link" href="#">
+         <p class="link-boxes-label">Install the Wazuh indexer</p>
 
 .. image:: ../../images/installation/Indexer-Circle.png
-     :align: center
-     :height: 61px
+   :align: center
+   :height: 61px
 
 .. raw:: html
 
-      </div>
-    </div>
-  
-    <div class="link-boxes-item future-step">
-      <a class="link-boxes-link" href="../wazuh-server/index.html">
-        <p class="link-boxes-label">Install the Wazuh server</p>
+     </div>
+   </div>
+
+   <div class="link-boxes-item future-step">
+     <a class="link-boxes-link" href="../wazuh-server/index.html">
+       <p class="link-boxes-label">Install the Wazuh server</p>
 
 .. image:: ../../images/installation/Server-noBG.png
-     :align: center
-     :height: 61px
+   :align: center
+   :height: 61px
 
 .. raw:: html
 
-      </a>
-    </div>
-  
-    <div class="link-boxes-item future-step">
-      <a class="link-boxes-link" href="../wazuh-dashboard/index.html">
-        <p class="link-boxes-label">Install the Wazuh dashboard</p>
+     </a>
+   </div>
+
+   <div class="link-boxes-item future-step">
+     <a class="link-boxes-link" href="../wazuh-dashboard/index.html">
+       <p class="link-boxes-label">Install the Wazuh dashboard</p>
 
 .. image:: ../../images/installation/Dashboard-noBG.png
-     :align: center
-     :height: 61px
-     
+   :align: center
+   :height: 61px
+
 .. raw:: html
 
-      </a>
-    </div>
-  </div>
+       </a>
+     </div>
+   </div>
 
 Requirements
 ------------
@@ -80,41 +80,36 @@ The Wazuh indexer requires a 64-bit Intel, AMD, or ARM Linux processor (x86_64/A
 Hardware recommendations
 ^^^^^^^^^^^^^^^^^^^^^^^^
 
-The Wazuh indexer can be installed as a single-node or as a multi-node cluster.
-
-- Hardware recommendations for each node
-                          
-  +-------------------------+-------------------------+-------------------------------+
-  |                         |  Minimum                |   Recommended                 |
-  +-------------------------+----------+--------------+--------------+----------------+
-  | Component               |  RAM (GB)|  CPU (cores) |  RAM (GB)    |   CPU (cores)  |
-  +=========================+==========+==============+==============+================+
-  | Wazuh indexer           |     4    |     2        |     16       |       8        |
-  +-------------------------+----------+--------------+--------------+----------------+
-
-
-- Disk space requirements
+You can install the Wazuh indexer as a single-node or multi-node cluster.
 
-  The amount of data depends on the generated alerts per second (APS). This table details the estimated disk space needed per agent to store 90 days of alerts on a Wazuh indexer server, depending on the type of monitored endpoints.
+-  Hardware recommendations for each node
 
-  +-------------------------------------------------+-----+---------------------------+
-  | Monitored endpoints                             | APS || Storage in Wazuh indexer |
-  |                                                 |     || (GB/90 days)             |
-  +=================================================+=====+===========================+
-  | Servers                                         | 0.25|           3.7             |
-  +-------------------------------------------------+-----+---------------------------+
-  | Workstations                                    | 0.1 |           1.5             |
-  +-------------------------------------------------+-----+---------------------------+
-  | Network devices                                 | 0.5 |           7.4             |
-  +-------------------------------------------------+-----+---------------------------+
+   +-------------------------+-------------------------+-------------------------------+
+   |                         |  Minimum                |   Recommended                 |
+   +-------------------------+----------+--------------+--------------+----------------+
+   | Component               |  RAM (GB)|  CPU (cores) |  RAM (GB)    |   CPU (cores)  |
+   +=========================+==========+==============+==============+================+
+   | Wazuh indexer           |     4    |     2        |     16       |       8        |
+   +-------------------------+----------+--------------+--------------+----------------+
 
-  For example, for an environment with 80 workstations, 10 servers, and 10 network devices, the storage needed on the Wazuh indexer server for 90 days of alerts is 230 GB. 
+-  Disk space requirements: The amount of disk space required depends on the generated alerts per second (APS). This table details the estimated disk space needed per agent to store 90 days of alerts on a Wazuh indexer server, depending on the type of monitored endpoints.
 
+   +-------------------------------------------------+-----+---------------------------+
+   | Monitored endpoints                             | APS || Storage in Wazuh indexer |
+   |                                                 |     || (GB/90 days)             |
+   +=================================================+=====+===========================+
+   | Servers                                         | 0.25|           3.7             |
+   +-------------------------------------------------+-----+---------------------------+
+   | Workstations                                    | 0.1 |           1.5             |
+   +-------------------------------------------------+-----+---------------------------+
+   | Network devices                                 | 0.5 |           7.4             |
+   +-------------------------------------------------+-----+---------------------------+
 
+   For example, for an environment with 80 workstations, 10 servers, and 10 network devices, the storage needed on the Wazuh indexer server for 90 days of alerts is 230 GB.
 
 .. toctree::
-    :hidden:
-    :maxdepth: 1
+   :hidden:
+   :maxdepth: 1
 
-    Assisted installation <installation-assistant>
-    Step-by-step installation <step-by-step>
+   Assisted installation <installation-assistant>
+   Step-by-step installation <step-by-step>