Reset a user password

Estimated reading time: 1 minute

This topic applies to Docker Enterprise.

The Docker Enterprise platform business, including products, customers, and employees, has been acquired by Mirantis, inc., effective 13-November-2019. For more information on the acquisition and how it may affect you and your business, refer to the Docker Enterprise Customer FAQ.

Change user passwords

Managed in UCP

Docker EE administrators can reset user passwords managed in UCP:

  1. Log in to UCP with administrator credentials.
  2. Navigate to Access Control > Users.
  3. Select the user whose password you want to change.
  4. Click Edit. Once on the “Update User” view, select Security from the left navigation.
  5. Enter the new password, confirm, and click Update Password.

Managed through LDAP

User passwords managed with an LDAP service must be changed on the LDAP server.

Change administrator passwords

Administrators who need to update their passwords can ask another administrator for help or SSH into a Docker Enterprise manager node and run:

docker run --net=host -v ucp-auth-api-certs:/tls -it "$(docker inspect --format '{{ .Spec.TaskTemplate.ContainerSpec.Image }}' ucp-auth-api)" "$(docker inspect --format '{{ index .Spec.TaskTemplate.ContainerSpec.Args 0 }}' ucp-auth-api)" passwd -i

With DEBUG Global Log Level

If you have DEBUG set as your global log level within UCP, running $(docker inspect --format '{{ index .Spec.TaskTemplate.ContainerSpec.Args 0 }} returns --debug instead of --db-addr. Pass Args 1 to $docker inspect instead to reset your admin password.

docker run --net=host -v ucp-auth-api-certs:/tls -it "$(docker inspect --format '{{ .Spec.TaskTemplate.ContainerSpec.Image }}' ucp-auth-api)" "$(docker inspect --format '{{ index .Spec.TaskTemplate.ContainerSpec.Args 1 }}' ucp-auth-api)" passwd -i
ucp, authentication, password