Replacing a host ID bound to license

As of Niagara 4.15, you can replace an already registered Niagara license to a host ID with new host ID. You can handle the replacement of the license directly from your station using the NRE command. Use the following steps to replace a host ID.

  • You have created a Niagara Central account (https://www.niagara-community.com) and you have access to Niagara Licensing.

  • You are a Niagara Licensing portal user with Write/WriteX permissions on Subscription License.

  • The subscription key is available and the host ID is already bound.

Using Workbench

  1. Open Workbench and make a platform connection to the Niagara instance.
  2. In the Nav tree, double-click the License Manager and click Register.
    The Device Registration window opens.

  3. Enter the subscription key, select the Replaces existing Host ID bound to this Subscription Key check box, and enter the host ID that is already registered with the entered subscription key.
  4. Click on the Verification URL to navigate to the web browser, paste the copied code from Workbench in the Code field, and click on Connect.


  5. On the Allow Access screen, click Allow to permit the Niagara instance to connect to the Niagara license server and to continue.
    The You're Connected screen opens to inform you that your device or app is now connected.

  6. Click Continue to replace the existing host ID bound to this subscription key.
  7. In Workbench > License Manager, the Licensing Complete dialog window informs you that the Niagara instance has been successfully registered and the host ID has been replaced.


  8. Click Ok.

Using NRE command

  1. Open the console command line for the Niagara instance whose host Id needs to be replaced. On a Linux Niagara instance, open the shell application.


  2. Run the command nre -replace <Existing Host ID> <Subscription Key> to initiate the replacement of the existing host ID.


  3. To navigate to the Enter Code screen in your web browser, locate and copy the Verification URL in the Niagara Command Line window and paste it into your web browser.
  4. Similarly, from the Niagara Command Line window, copy the User Code, paste it in the Code entry field, and click Connect.


  5. On the Allow Access screen, click Allow to permit the Niagara instance to connect to the Niagara license server.
    Note: If you have successfully granted access to a specific application 5 times, which is the maximum allowed, the following applies: If you approve the 6. request, the oldest approval will automatically be revoked. To prevent this, you can either deny this request or manually revoke an approval in your personal settings.


    The You're Connected screen opens to inform you that your device or app is now connected.
  6. Click Continue to replace the existing host ID bound to this subscription key.
    Upon registration, the Niagara Command Line window confirms that the device is registered with the subscription licensing system and that the existing host ID was replaced successfully.