---
title: "cluster set-password"
slug: "cluster-set-password"
tags: ["5.4"]
updated: 2026-10-28T01:52:11Z
published: 2026-10-28T01:52:11Z
canonical: "docs.vastdata.com/cluster-set-password"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vastdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# cluster set-password

This command sets passwords for the OS and IPMI admin users on all CNodes and DNodes in the cluster. Servers that are added to the cluster or re-activated after the command is run receive the same passwords.

## Usage

```plaintext
cluster set-password [--root]
                     [--vastdata]
                     [--ipmi]
```

## Options

| `--root` | Sets the password of the Linux OS superuser on all CNodes and DNodes in the cluster. The user name is (and remains) *root*. After you enter the command, you are prompted to enter the new password and subsequently to re-enter the new password. The VAST CLI then informs you when the password change is finished. |
| --- | --- |
| `--vastdata` | Sets the password of the Linux OS user *vastdata* on all CNodes and DNodes in the cluster. The user name is (and remains) *vastdata*. After you enter the command, you are prompted to enter the new password and subsequently to re-enter the new password. The VAST CLI then informs you when the password change is finished. |
| `--ipmi` | Sets the password of the IPMI admin user on all CNodes and DNodes in the cluster. The user name is (and remains) *admin*. After you enter the command, you are prompted to enter the new password and subsequently to re-enter the new password. The VAST CLI then informs you when the password change is finished. > [!WARNING] > Caution > > - VMS accepts IPMI passwords that meet the following generic validation criteria: > > - At least one upper case letter > - At least one lower case letter > - At least one digit > - Depending on CNode and DNode models, the vendor may have additional validation criteria such as requiring or not allowing a special character. Running this command with a password that does not meet all vendor criteria may result in a failure changing the password on specific affected nodes. > - The command cannot be rolled back. |

## Example

This example changes the IPMI password for all CNodes and DNodes to *admin1212*:

```plaintext
vcli: admin> cluster set-password --ipmi 
Enter new password: 
Password: admin1212
Re-enter new password:
Password: admin1212
Setting new password for user ipmi 

Waiting ...

[2019-12-23 11:04:27] mycluster: changing password for all hosts ... \
[2019-12-23 11:04:36] finished changing password ... |

Completed
```