ENTERPRISE

Creating a new initial admin user

  • Last updated: October 14, 2021

  • Read time: 1 Minute

If you've forgotten the credentials that you set for the admin user during the installation wizard, you'll need to create a new user by running the adminusercreator command-line utility. You can find this in the Burp Suite Enterprise Edition installation directory.

Note

You should only use this approach if you are the only administrator and are completely locked out of the system. If there are other administrators who are still able to log in, they can just reset the password for your existing user from the web interface.

You need to provide the following parameters:

Parameter Description
--username The username you want to set for the new user. Note that this cannot be the same as an existing user.
--password The initial password that you want to set for the new user.
--email The email address that you want to set for the new user.
--dbUrl The connection string/JDBC URL for your database.

If you've forgotten this, you can retrieve it from the Enterprise server's configuration file. Go to <installation-directory>/enterpriseServer/<version-number>/enterprise-server.config and copy the admin_repository.url property.
--dbUsername The database username for the Enterprise server.

You can also retrieve this from the enterprise-server.config file under admin_repository.username.
--dbPassword The database password for the Enterprise server user.

You can also retrieve this from the enterprise-server.config file under admin_repository.password.

Example

The following is an example command for running the adminusercreator:

./adminusercreator --username=new_admin --password=letmein --email=admin@example.com --dbUrl="jdbc:<your-database-url>" --dbUsername=burp_enterprise --dbPassword=securepassword