-
Notifications
You must be signed in to change notification settings - Fork 384
Description
📌 Request Details
Required Information
- Target version: 4.13
- Request type
- Fixes or corrections
- Affected Documentation
- Documentation section(s): Changing the passwords in a distributed environment
- Specific page URLs: https://documentation.wazuh.com/current/user-manual/user-administration/password-management.html
Description
In the Wazuh documentation section “Changing the passwords in a distributed environment”, the second step needs an update. The current command example does not match the actual script usage or output.
🛠 Additional Details
According to the current documentation, the command to update the API password is shown as:
bash wazuh-passwords-tool.sh --api --admin-user wazuh --admin-password <WAZUH_PASSWORD>
However, when executing this command, the output indicates that the correct flags differ.
For example, running the command below:
bash wazuh-passwords-tool.sh --api --admin-user wazuh --admin-password Secr3tP4ssw*rd
Produces the following usage output (see attached image):

Correct Command
The correct syntax should be:
bash wazuh-passwords-tool.sh --api -u wazuh -p <new-password> --admin-user wazuh-wui --admin-password <wazuh-wui-user-password>
You must replace <wazuh-wui-user-password>
with the current wazuh-wui
password, which can be retrieved by running:
sudo tail /usr/share/wazuh-dashboard/data/wazuh/config/wazuh.yml
Example output:

Suggested Fix
Update the second step in the documentation with the correct command and include a short note explaining how to retrieve the current wazuh-wui
password from wazuh.yml
.