How to manually configure SMTP on Tableau Server Linux environment

Updated SMTP Configuration Steps for Tableau Server (Linux)

1. Access the Server

Log in to the Tableau Server host as a user with appropriate permissions.

2. Set SMTP Configuration Keys

Use the following commands to configure your SMTP settings:

tsm configuration set -k svcmonitor.notification.smtp.server -v "smtp.example.com"
tsm configuration set -k svcmonitor.notification.smtp.port -v "587"
tsm configuration set -k svcmonitor.notification.smtp.send_account -v "your_username"
tsm configuration set -k svcmonitor.notification.smtp.password -v "your_password"
tsm configuration set -k svcmonitor.notification.smtp.from_address -v "your_email@example.com"
tsm configuration set -k svcmonitor.notification.smtp.ssl_enabled -v "true"

Replace the placeholder values (smtp.example.com, your_username, etc.) with your actual SMTP server details.

3. Apply Configuration Changes

After setting the configuration keys, apply the changes using:

tsm pending-changes apply

This command will prompt you to restart Tableau Server if necessary.

4. Restart Tableau Server (If Prompted)

If prompted after applying pending changes, restart Tableau Server to ensure the new settings take effect:

tsm restart

5. Test SMTP Configuration

Verify that Tableau Server can connect to your SMTP server by running:

tsm email test-smtp-connection

This command attempts to establish a connection with the configured SMTP server and returns the connection status along with SMTP configuration details.

Note: Ensure that your SMTP server supports STARTTLS, as Tableau Server only supports this method for TLS encryption.

For more detailed information on configuring SMTP settings, refer to the official Tableau documentation: