Moving BarTender Security Settings to a New System Follow


BarTender Content Team


This guide provides instructions on how to move BarTender security settings to a different machine. 

Applicable to 

  • BarTender 2016 and later


BarTender 2016

Note 1: If security has been stored in the BarTender System Database instead of a local file, make sure the 2nd computer also has access to this same BarTender System Database (only available in the Enterprise Automation Edition of BarTender).
Note 2: These instructions must be followed exactly otherwise you might lock yourself out of the Administration Console. If you are locked out of the Administration Console, follow the steps here.

Part 1: build the security file

This part only needs to be done once. It is recommended to do this as an administrator so you don't lock yourself out of the admin console:

  1. On one of the computers, Open the Admin Console.
  2. Navigate to the security section and check the checkbox. We'll be using the Local File for security.
  3. Set all your permissions. Make note that anything explicitly marked as denied will deny this option for all users of this group, regardless of if they can access this feature in another group.
  4. Once you've set the permissions, click OK to close the Admin Console.
  5. Navigate to the location of the xml file. By default this is C:\ProgramData\Seagull Security\. Copy the SecuritySettings.xml for use in the next section.

Part 2: applying the settings.

This part must be done for each computer where you want to apply these settings: 

  1. For each computer, open the Administration Console.
  2. Like step 2 above, enable security for this PC but this time, do not set any user permissions.
  3. Click OK and close the Admin Console.
  4. On your Windows Services list, stop the "BarTender System Service"
  5. Navigate to the security folder. By default, this is C:\ProgramData\Seagull Security\
  6. Paste the xml created in Part 1 here. When asked if you want to replace the file, confirm this.
  7. Start the "BarTender System Service"
  8. When you open the Administration Console, you should now see your security settings applied for this computer.

BarTender 2019 and later

In BarTender 2019 and later the Security settings are saved in the system database. This means that migrating a locally stored system database will also migrate security settings. For a centrally stored system database security settings are shared between all Computers connecting to the same system database.(only available in the Enterprise Automation Edition of BarTender)

Additional resources

Do you have feedback or questions on this article? We encourage you to post them on our Community Forums