ENTERPRISE

Resetting your admin password

• Last updated: July 3, 2023

• Read time: 2 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, we've provided a script that allows you to reset the default admin user password without logging in to the web interface.

Resetting your admin password (standard deployments)

To execute the resetAdministratorPassword script found in your Burp Suite Enterprise Edition installation directory:

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 (Kubernetes)

To reset your admin password on a Kubernetes deployment, 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.