ENTERPRISE

Resetting your admin password

  • Last updated: May 17, 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. In case you are the only admin user, we've provided a script that allows you to reset your password or create a new user without logging in to the web interface.

Note

You can't use this script if you have an API user or SCIM user in Burp Suite Enterprise Edition with the name administrator. In this case, you need to use a different script that allows you to create a new admin user with a custom name.

Resetting your admin password (standard deployments)

  1. From a command prompt, execute the resetAdminPassword script found in your Burp Suite Enterprise Edition installation directory, entering the new password that you want to set as the only argument:

    /<your-installation-directory>/resetAdminPassword.sh <new-password>
  2. 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.

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/resetAdminPassword <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.