tsm status

You can use the tsm status command to display the status of Tableau Server and individual services (processes) that run as part of Tableau Server.


tsm status [global options]


-v, --verbose


Display status for every node in the Tableau Server cluster.

tsm status will return one of these potential statuses for a Tableau Server node:

  • RUNNING: The node is running without error statuses for any service or process.

  • DEGRADED: The node is running with one or more primary services - such as the repository - in an error state. If you have a single instance of the Messaging service and it fails,

  • ERROR: All primary services or processes are in an error state on the node.

  • STOPPED: The node is stopped, with no error statuses.

When running tsm status with the --verboseoption, TSM will return a status for each individual service (process). Possible status messages include:

  • is running: The service is running.

  • status is unavailable: The status cannot be determined - such as when services are starting up.

  • is in a degraded state: The service is running, but returning errors. This status indicates the service failed to install properly, has not been configured, or has failed in some way.

  • is in an error state: The service is running, but returning errors. This status indicates the service failed to install properly, or has not been configured.

  • is synchronizing: The File Store process is synchronizing with another instance of File Store.

  • is decommissioning: The File Store process is being decommissioned.

  • is running (Active Repository): The active repository is running. This is the expected status.

  • is running (Passive Repository): The passive repository is running. This is the expected status when there are two repositories configured.

  • is stopped: The service is stopped. This does not mean a service is in an error or problem state. Some services only run when needed (the Database Maintenance service for example).

Global options

-h, --help


Show the command help.

-p, --password <password>

Required, along with -u or --username if no session is active.

Specify the password for the user specified in -u or --username.

If the password includes spaces or special characters, enclose it in quotes:

--password 'my password'

-s, --server https://<hostname>:8850


Use the specified address for Tableau Services Manager. The URL must start with https, include port 8850, and use the server name not the IP address. For example https://<tsm_hostname>:8850. If no server is specified, https://<localhost | dnsname>:8850 is assumed.



Use this flag to trust the self-signed certificate on the TSM controller. For more information about certificate trust and CLI connections, see Connecting TSM clients.

-u, --username <user>

Required if no session is active, along with -p or --password.

Specify a user account. If you do not include this option, the command is run using credentials you signed in with.

Thanks for your feedback! There was an error submitting your feedback. Please try again.