Restore Passwords To Recover Admin User Rights Using System Properties
Platform Notice: Server and Data Center Only - This article only applies to Atlassian products on the server and data center platforms.
If you're unable to log in to Crowd as an administrator (for example, you've lost the administrator password) you can start Crowd in recovery mode to recover your admin user rights.
This process applies to versions 3.5.2, 3.6.2, 3.7.1 and greater only
- For versions 3.5.1, 3.6.1, 3.7.0 and prior, please see Restoring Passwords To Recover Admin User Rights via Database. These versions were affected by CWD-5116
Use recovery mode to restore access
Recovery mode works by creating a virtual user directory with a temporary admin account. You set the password for this admin account when applying the system property. Users can continue to log in and access Crowd while it is in recovery mode.
To recover administrator user rights:
- Stop Crowd.
setenv.batand add the following system property, replacing
<your-password>with a unique, temporary password.
- Start Crowd manually (don't start Crowd as a service).
- Log in to Crowd with the username recovery_admin and the temporary password you specified in the system property.
- Reset the password for your existing admin account, or create a new account and add it to the appropriate administrator group.
- Confirm that you can successfully log in with your new account.
- Stop Crowd.
setenv.batand remove the system property.
- Restart Crowd using your usual method (manually or by starting the service).
Good to know:
- Remove the system property as soon as you have restored admin access.
- Don't leave Crowd in recovery mode, or use the recovery_admin account as a regular administrator account.
- Your temporary password should be unique. Don't use an existing password or the one you intend to use for your admin account.