Skip to main content

Reset credentials

When to use this guide​

Use these instructions if you encounter any of the following scenarios:

  • You've forgotten your Administrator Panel username or password
  • You accidentally changed your password and can't remember the new one
  • You're locked out of the web Administrator Panel due to authentication issues

Option 1 - Ask another administrator​

If another administrator can still log in, they can reset your password for you:

  1. Log in to the Administrator Panel at https://<host>:7081.
  2. Open the Access Control page.
  3. Edit your user account and set a new password.

Option 2 - Set a new password with mshctl​

If no administrator can log in, set a new password directly on the server with the mshctl command-line tool shipped in the installation directory. It updates the password of an existing Administrator Panel user and leaves everything else untouched, so there is no need to stop the service or to recreate other accounts.

Follow these steps on the mail server:

  1. Connect to the mail server using your SSH credentials.
  2. Run change-password with the login name of the account, for example the default admin: 
    sudo -u msh /opt/msh-zr/bin/mshctl change-password admin
  3. Type the new password twice when prompted. The input is not echoed. 
    New password for 'admin':
    Repeat new password:
    Password changed for user 'admin'.
  4. Log in at https://<host>:7081 with that username and the new password.

mshctl reports an error when the user does not exist, when the two passwords differ or when the password is empty, and changes nothing in that case. Run mshctl -h change-password for the full usage.