---
schema_version: "1"
id: 3ef0521e6d4616f10d9fa9396a2dbb2e8cb96a131566617aee349ae4cccab6b0
title: tsm Command Line Reference
collection: tableau
version: current
locale: en-gb
portal_url: https://docs.salesforce.com/tableau/current/en-gb/server/tsm.md
canonical_url: https://help.tableau.com/current/server/en-gb/tsm.htm
source_site: help.tableau.com
content_type: documentation
content_hash: f61bf4931a0073966971b7609461c1046d93d2d81725af817a1b15b406c34f32
description: Reference for the Tableau Services Manager (TSM) command line interface.
---
[Skip to main content](#main-content)

# tsm Command Line Reference

The topics in this section include reference content for Tableau Services Manager (TSM) command line interface (CLI) to support Tableau Server.

TSM is used to manage installation and configuration of Tableau Server. To learn more about TSM, see [Tableau Services Manager Overview](https://help.tableau.com/current/server/en-gb/tsm_overview.htm).

You can automate the installation and configuration tasks supported by the TSM CLI using the TSM API. To learn more about the prerelease (Alpha) TSM API, see [Tableau Services Manager API](https://help.tableau.com/v0.0/api/tsm_api/en-gb/index.htm).

## Using the tsm CLI

You can run tsm commands on the initial node (the node where TSM is installed), or on any additional node in the cluster.

To run tsm commands, you need to open Windows Command Prompt. Do not use PowerShell to run tsm commands. Using PowerShell can cause unexpected behaviour.

1. Open Windows Command Prompt with an account that is a member of the Administrators group on a node in the cluster.
2. Run the command you want. If you are running the command from a node other than the initial node, include the `-s` option to specify the URL of the initial node by name (not IP address), and include the TSM port, 8850.
    
    To see the version of TSM and Tableau Server from the initial node:
    
    `tsm version`
    
    To see the version of TSM and Tableau Server from an additional node:
    
    `tsm version -s https://<inital_node_name>:8850`
    
    For example:
    
    `tsm version -s https://myTableauHost:8850`

## Authenticating with tsm CLI

Beginning in the 2019.2 release of Tableau Server, running tsm commands will not require you to enter a password if the following are true:

- The account you are running commands with is a member of the TSM-authorised group, which is the local Administrators group on the Windows computer.
- You are running commands locally on the Tableau Server that is running the Tableau Server Administration Controller service. By default, the Tableau Server Administration Controller service is installed and configured on the initial node in a distributed deployment.

### Logging into tsm CLI locally

If you are running tsm commands on the local computer with user account that is a member of a TSM-authorised group, then you will not need to specify a password. In this case, just run the command, for example:

`tsm version`

### Logging into tsm CLI remotely

If you are running TSM commands from a node in a cluster where the Tableau Server Administration Controller service is not running, then you must authenticate a session with the Tableau Server Administration Controller service on the remote computer before you can run commands. For example, run the following command:

`tsm login -s <server_name> -u <account_name>`

Where `<server_name>` is the name of the node where the Tableau Server Administration Controller service is running and `<account_name>` is an account that is a member of a TSM-authorised group.

After running this command, you will be prompted for a password. After the account has been authenticated, you can run TSM commands.

As a security best practice, do not expose the TSM port (by default, `8850`) to the internet.

## Scripting and automating with tsm CLI

TSM is a batch file. To run TSM commands in another batch file, use the `call` command. For example "`call tsm maintenance ziplogs`". Doing this will return control to the batch file.

To run automation on a Tableau Server without a password in the script file, run the script on the initial node and with an account in the proper TSM-authorised group. See the "Authenticating" section above.

## Viewing help content in the shell

To view minimal help content from a command line, use the `tsm help` category.

### Synopsis

`tsm help [category] [command]`

### Commands

`tsm help`

Help for all tsm commands

`tsm help <category>`

Show help for a specific command category. For example, `tsm help authentication`.

`tsm help <category> <command>`

Show help for a specific command. For example, `tsm help authentication open-id`.

`tsm help commands`

List all top-level commands or categories.

## Categories

## Other articles in this section