Updating Master Password on Transporter

Product version: All

Last modified: 10 June 2025

Problem

How to update the master password on a Transporter due to a credential change policy or password rotation procedure?

Background

The master password is used to secure stored credentials on Transporters. If the password needs to be updated, you must stop the Transporter services, apply the new password at the OS level, and then update the UI configuration.

The password must meet the following criteria:

  • Minimum length: 5 characters

  • Maximum length: 50 characters

Solution

Follow these steps to change the master password:

  1. Log in to the machine where the Transporter is installed (via local access or SSH).

  2. Stop the Transporter Services. Refer to the Starting and Stopping Product Services.

  3. Navigate to the Transporter Folder:

  • On Windows:

C:\Program Files\NAKIVO Backup & Replication\transporter

  • On Linux:

/opt/nakivo/transporter

  • On Synology with Full NAKIVO Backup & Replication installed:

/"volumenumber"/@appstore/NBR

  • On Synology with Transporter only:

/"volumenumber"/@appstore/NBR-Transporter

  • On QNAP with Full NAKIVO Backup & Replication installed:

/share/CACHEDEV1_DATA/.qpkg/NBR/

  • On QNAP with Transporter only:

/share/CACHEDEV1_DATA/.qpkg/NBR-Transporter

Note

On QNAP devices, when volumes 2 and 3 are added, their corresponding data folder names are CACHEDEV2_DATA and CACHEDEV3_DATA, respectively.

  1. Replace new_master_password with the new password of your choice. Make sure the password meets the complexity requirements listed above.

  • On Windows:

bhsvc.exe -b new_master_password

  • On Linux:

./bhsvc -b new_master_password

  1. Restart Transporter services. Refer to Starting and Stopping Product Services.

  1. Navigate to Settings > Nodes to edit the appropriate Transporter.

  1. Click ellipsis (...) and select Edit. This opens the Transporter editing window.

  2. Enter the new master password.

  3. If the Master password field is disabled, and you cannot enter the new password:

    1. Right-click the Master password field in your browser.

    2. Select Inspect to open developer tools.

    3. Locate the corresponding HTML element and remove the disabled attribute.

    4. Press Enter to apply the change.

    5. You should now be able to enter the new master password in the UI.