Set or update the local administrator password


This content is being retired and may not be updated in the future. The support for Machine Learning Server will end on July 1, 2022. For more information, see What's happening to Machine Learning Server?

Applies to: Machine Learning Server, Microsoft R Server

When no other form of authentication is used for Machine Learning Server, you must define a password for the local administrator account called 'admin'. If you enable another form of authentication, the local administrator account is automatically disabled.

The admin password must be 8-16 characters long and contain:

  • At least one uppercase character
  • At least one lowercase character
  • At least one number
  • At least one of the following special characters:
    ~ ! @ # $ % ^ & ( ) - _ + = | < > \ / ; : , .

Machine Learning Server 9.3 and later

In Machine Learning Server 9.3 and later, you can use admin extension of the Azure Command Line Interface (Azure CLI) to set up and manage your configuration, including updating the local 'admin' account password.


  • This password is set while you are first configuring your nodes.
  • You do not need an Azure subscription to use this CLI. It is installed as part of Machine Learning Server and runs locally.

To update the password:

  1. On the machine hosting the node, launch a command-line window or terminal with administrator (Windows) or root/sudo (Linux) privileges.

  2. Run the command to update the 'admin' password.

    # With elevated privileges, run the following commands.
    # Update the admin account password
    az ml admin password set --old-password <OLD-PW> --admin-password <NEW-PW> --confirm-password <NEW-PW>

Earlier versions: 9.0 - 9.2

To set or update the password:

  1. Launch the administration utility.

  2. From the main menu, choose the option to set a password for the local 'admin' account.

  3. If a password was already defined, provide the current password.

  4. When prompted, enter the new password for this administrator account. If your configuration has multiple web nodes, we recommend the same password be used.

  5. Confirm the password.


You can bypass script interface using the argument '-setpassword '. Learn about all command-line switches for this script, here. For example:
dotnet Microsoft.MLServer.Utils.AdminUtil\Microsoft.MLServer.Utils.AdminUtil.dll -setpassword my-password