Skip to content

Wazuh API user password reset documentation command issue #8959

@Hasitha9796

Description

@Hasitha9796

📌 Request Details

Required Information

  • Target version: 4.13

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):

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:

Image

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.

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions