= MigratePasswordsToTokens

== NAME
MigratePasswordsToTokens - Convert HTTP passwords of all users
to authentication tokens.

== SYNOPSIS
[verse]
--
_java_ -jar gerrit.war _MigratePasswordsToTokens_
  -d <SITE_PATH>
  --lifetime <LIFETIME>
--

== DESCRIPTION
The HTTP passwords have been deprecated in favor of authentication tokens.
This command migrates all users' HTTP passwords to authentication tokens.
It will delete the password from the `username` ExternalID and create a new
token in the user-ref of the account. The new token will have the ID
`legacy` and have the same value as the password.

== OPTIONS

-d::
--site-path::
	Path of the Gerrit site

--lifetime::
	Default lifetime of the tokens

== CONTEXT
This command can only be run offline with direct access to the server's
site.

== EXAMPLES
To convert the HTTP passwords to tokens:

----
    $ java -jar gerrit.war MigratePasswordsToTokens -d site_path
----

== SEE ALSO

GERRIT
------
Part of link:index.html[Gerrit Code Review]

SEARCHBOX
---------