Restore Passwords To Recover Admin User Rights

If you're unable to log in to Confluence as an administrator (for example, you've lost the administrator password) you can start Confluence in recovery mode to recover your admin user rights.

If you know the admin username, and it has a valid email address, you can reset the password using the forgot password link on the log in screen. We'll send a link to your admin email account to reset your password.

On this page:

As an administrator, you may find yourself locked out of Confluence because:

  • You've imported a site from Cloud, and it does not contain a system administrator account.
  • You've forgotten the password to the administrator account, and don't have access to the email address associated with it.
  • You're using an external directory or Jira for user management, have disabled the built in user management, and your external directory is not currently available. 
  • You need to make a change to the configuration of an external user directory in Confluence while that directory is not available. 

In any of these situations you can use recovery mode to restore administrator access to Confluence. 

Using Confluence 6.5.0 or earlier? You'll need to use the database method to recover your admin user rights. See the earlier documentation.

Using Confluence 8.9.x or earlier? You'll need to use a different method. See the earlier documentation.

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 Confluence while it is in recovery mode.

From Confluence 9, the recovery method has changed to using a generated recovery username. See the steps below to use recovery mode in Confluence 9.0 and later.

To recover administrator user rights:

  1. Stop Confluence.
  2. Add the following system property, replacing <your-password> with a unique, temporary password. 

    -Datlassian.recovery.password=<your-password>

    The way you do this depends on how you run Confluence. See Configuring System Properties for more information on how to apply system properties.

  3. Start Confluence using your usual method.
  4. Check the atlassian-confluence-security.log file and find a newly generated recovery username:

    Recovery admin username: '{username}'
  5. Log in with the recovery username from the log and the temporary password you specified in the system property. 

  6. Reset the password for your existing admin account, or create a new account and add it to the appropriate administrator group. 
  7. Confirm that you can successfully log in with your new account.
  8. Stop Confluence. 
  9. Remove the system property you added earlier.  
  10. Restart Confluence 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 Confluence in recovery mode, or use the recovery_admin account as a regular administrator account.  
  • Your temporary password should be a unique. Don't use an existing password or the one you intend to use for your admin account. 
Last modified on Jul 30, 2024

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.