Configure a Custom TSM Administration Group

This topic describes how to configure a custom TSM administration group.

By default, the Tableau Server installation process creates a group called tsmadmin. Users in this group are authorized as administrators of TSM. You can change this default group during installation. See Help Output for initialize-tsm Script.

If you have already installed Tableau Server and wish to change the group used for TSM administration, follow the procedure in this topic.

You can configure Tableau Server to use an arbitrary group as a custom TSM administration group. Once configured, any user that is a member of the custom group will be able to administer TSM.

Step 1: Create the new group

Create a new group on your computer. Do not change the permissions on the default group as created by Linux.

Step 2: Configure Tableau Server

The custom TSM administration group name is stored in the tsm.authorized.groups configuration key. If you want to specify a group name (other than tsmadmin) then you will need to update the tsm.authorized.groups configuration key and then restart Tableau Server.

Use the tsm configuration set command to set the group name value. For example, to change the TSM administrative group name to myadmingroup, run the following commands:

tsm configuration set -k tsm.authorized.groups -v myadmingroup
tsm pending-changes apply


  • Setting the tsm.authorized.groups configuration key overwrites any existing value stored on that key.
  • If you have users in the existing tsmadmin group, and you overwrite the tsm.authorized.groups configuration key with a new value, then the users in the existing tsmadmin group will no longer be authorized for TSM.
  • You can specify multiple groups by entering a comma-separated list of group names as the value.

Step 3: Add users to the new group

After you finished setting tsm.authorized.groups, any user in the new group(s) that you have specified will have full TSM administrative rights on Tableau Server.

Thanks for your feedback!