---
schema_version: "1"
id: d28912c38d39d5591b1fef42a489f38488165c4522e64a81484bc411e246e72f
title: tsm email
collection: tableau
version: current
locale: en-us
portal_url: https://docs.salesforce.com/tableau/current/en-us/server-linux/cli_email.md
canonical_url: https://help.tableau.com/current/server-linux/en-us/cli_email.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 30d2dfca3105af4a69a4c15745f5cb08b254b31c2953e24d60ab148cbc924791
description: Reference for the tsm email command to view and test the Tableau Server SMTP configuration.
---
[Skip to main content](#main-content)

# tsm email

Use the `tsm email` command to view and test your SMTP configuration.

For more information about configuring SMTP, see [Configure SMTP Setup](https://help.tableau.com/current/server-linux/en-us/config_smtp.htm).

## tsm email test-smtp-connection

Run this command to test the STMP connection. When run, TSM will attempt to establish a connection with the SMTP server that you have configured for Tableau Server. TSM will also return a connection status and the details of the SMTP configuration.

In some cases, the command will return a false-positive status. For example, if your Postfix SMTP server is set to require TLS, but Tableau Server is not configured for TLS, the connection is established and TSM will report a succesful connection. However, in this scenario, Postfix actually rejects the email message after TSM has connected.

### Synopsis

`tsm email test-smtp-connection [global options]`

## Global options

\-h, --help

Optional.

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

Optional.

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.

\--trust-admin-controller-cert

Optional.

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](https://help.tableau.com/current/server-linux/en-us/tsm_overview.htm#Connecti).

\-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.