[Other doc versions]
This page describes how to recover administrator access for Stash 2.11 and later. For releases prior to that, refer to Restoring the Stash Administrator's Password.
As an administrator, you may find yourself locked out of Stash and unable to log in. This situation can arise when all users are managed externally from Stash, and Stash becomes unable to access those user directories for some reason, including:
The lockout recovery process for Stash is:
<Stash installation directory>
setenv.sh file (or
setenv.bat on Windows) and add the "
-Datlassian.recovery.password=temporarypassword" argument to the
JVM_SUPPORT_RECOMMENDED_ARGS property. The property value must be non-blank, and should look like this when you've done that:
Here we are using "
temporarypassword", but you should use your own value.
If you are starting Stash as a Windows Service ...
If you are running Stash as a Windows service, please follow the steps outlined on Change atlassian.recovery.password when installed as a Windows service instead. The
setenv.bat file is not used by the Windows service and changes there will, therefore, have no effect.
setenv.sh, and restart Stash as usual.