Enterprise Edition

Resetting your admin password

• Last updated: July 16, 2024

• Read time: 3 Minutes

The first time you launch Burp Suite Enterprise Edition, you're prompted to set a password for an initial administrator user so that you can log in and complete the setup process. If you lose or forget these credentials, you need to reset your password.

If you've already created additional admin users, you can simply ask one of them to reset your password from the Teams page, just like any other user. If you are the only admin user, the process you need to follow to reset your password depends on how you deployed Burp Suite Enterprise Edition.

Resetting your admin password on a Cloud instance

Cloud

To reset your admin password on a Cloud instance, you need to request a password reset from the Sign in page:

1. Go to the Sign in page and click Forgot password. The Reset your password page is displayed.

2. Enter the email address for your admin account and click Request password reset. Burp Suite Enterprise Edition sends a reset email to the named account.

3. Open the email and click the URL. Burp Suite Enterprise Edition generates a new password and opens the Here's your new password page.

4. Copy the new password and store it somewhere secure, such as a password manager.

5. If required, click Go to login to display the Sign in page and then log in with your email and newly-created password.

Resetting your admin password on a self-hosted standard instance

Self-hosted

To reset your admin password on a standard, self-hosted instance of Burp Suite Enterprise Edition, we've provided a resetAdministratorPassword script. This script enables you to reset the default admin user password without logging in to the web interface. It can be found in your Burp Suite Enterprise Edition installation directory.

To run the script:

Windows

1. Open a command prompt.

2. Enter the following command, with your installation directory and the new password that you want to set:

   "<your-installation-directory>\resetAdministratorPassword" <new-password>

3. Log in to Burp Suite Enterprise Edition as normal with the username administrator and the password you just set.

Linux

1. Open the Linux Terminal.

2. Navigate to the installation directory:

   cd <your-installation-directory>

3. Run the following command:

   sudo ./resetAdministratorPassword <new-password>

Resetting your admin password on a self-hosted Kubernetes instance

Self-hosted

To reset your admin password on a Kubernetes instance, you need to use the kubectl command. For more information on how to connect and run commands via kubectl, consult the kubectl documentation or your cloud provider's documentation.

1. Connect to your Burp Suite Enterprise Edition Kubernetes cluster.

2. Run the following command to output the details of your Burp Suite Enterprise Edition pods:

   kubectl -n bsee get pods

3. In the output, find the name of the Enterprise server pod. This should begin with bsee-enterprise-server-deployment- followed by a unique identifier.

4. Run the following command to execute the script and reset the password for the administrator user:

   kubectl -n bsee exec <your-Enterprise-server-pod-name> -- ./bin/resetAdministratorPassword <your-new-password>

5. Log in to Burp Suite Enterprise Edition as normal with the username administrator and the password you just set.