ENTERPRISE

Resetting your admin password

  • Last updated: September 30, 2022

  • Read time: 2 Minutes

The first time you launch Burp Suite Enterprise Edition, you're prompted to set a username and 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>

Note

If no user with the name administrator exists, one will be created and assigned the new password.

Resetting your admin password (Kubernetes)

To reset your admin password on a Kubernetes deployment, you need to use the kubectl command. If your cluster is deployed to the cloud, you may need to install the kubectl tool for your cloud platform's built-in CLI in your order to run this command. Consult your cloud provider's documentation for more information.

  1. Make sure that your cluster is publicly accessible.

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

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

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

  5. 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>
  6. Log in to Burp Suite Enterprise Edition as normal with the username administrator and the password you just set.

Note

If no user with the name administrator exists, one will be created and assigned the new password.

Was this article helpful?