Lockout recovery process
This page describes how to recover administrator access for Bamboo 6.6 and later.
As an administrator, you may find yourself locked out of Bamboo and unable to log in. This can happen for various reasons, including:
- The external user directory server is not accessible (because the network is down, or the directory is down, or the directory has been moved to another IP address).
- The admin password has been forgotten or lost.
- The Bamboo instance is not configured properly and then restarted.
To regain your access to Bamboo:
For operating system and installation specific instructions for configuring a Java property for Bamboo, please see: Configuring your system properties
Linux Example: Edit the
<Bamboo_installation_directory>\bin\setenv.shfile and add the
"value to the
The property value must not be blank, and should look like this when you've done that:
# Occasionally Atlassian Support may recommend that you set some specific JVM arguments. # You can use this variable to do that. Simply uncomment the below line and add any required # arguments. Note however, if this environment variable has been set in the environment of the # user running this script, uncommenting the below will override that. # JVM_SUPPORT_RECOMMENDED_ARGS=-Datlassian.recovery.password=temporarypassword
Here we are using t
emporarypasswordbut you should use your own value.
- Restart your Bamboo instance.
- Log in to Bamboo using the
recovery_adminusername and the temporary password specified in Step 1.
Repair your Bamboo configuration.
In the recovery mode, Bamboo creates an additional account with administrative privileges to allow you to fix your configuration. These privileges are removed when Bamboo restarts without the recovery mode. We strongly recommend that you do not perform any additional actions while Bamboo is in recovery mode.
- Confirm your ability to log in with your usual admin profile.
- Shut down Bamboo and remove the
- Start Bamboo again.