Before you install...

Note: You can find additional information about technical specifications for Tableau Server on the Tableau web site, here.

This topic includes requirements and recommendations that you must consider before you install Tableau Server into a production environment.

If you want to install a single server, or if you want to do a minimal installation for test purposes, refer to our single-server installation guide, Everybody's Install Guide.

If you are deploying Tableau Server in a distributed cluster, review Distributed Requirements in addition to the requirements and recommendations described in this topic.

If you are migrating from Tableau Server on Windows to Tableau Server on Linux, see Migrate Tableau Server from Windows to Linux.

Hardware recommendations

The following list describes the minimum hardware recommendations for a single- node installation of Tableau Server:

  • 8 core, 2.0 GHz or higher processor

  • 64-bit processor architecture

  • 32 GB memory

  • 50 GB disk space available, with a minimum of 15 GB allocated to the /opt directory, and the remainder allocated to the /var directory for data storage. See the section, Data directory, below.

    Important: The disk space requirement cannot be checked until you initialize TSM. If you don’t have enough space, you won’t be told this until after you install the Tableau Server package.

To see the full list of recommendations and to see the minimum requirements, see Minimum Hardware Requirements and Recommendations for Tableau Server.

For public cloud deployments on Amazon Web Services and Google Cloud Platform, their “vCPU” is actually a CPU hyper-thread, and not a full CPU core. When sizing cloud instances, you will need twice as many vCPU as the Tableau Server CPU core requirements given (4 vCPU for a minimum trial installation, 16 vCPU for a recommended installation).

Operating system requirements

The following distributions of Linux are supported:

  • Red Hat Enterprise Linux (RHEL) 7.3 and higher, CentOS 7.3 and higher, Oracle Linux 7.3 and higher, and Amazon Linux 2.

    These distributions are collectively referred to in this documentation as RHEL-like.

    RHEL 8 is not supported.

  • The latest versions of Ubuntu 16.04 and 18.04 LTS only.

    Non-LTS releases are not supported

Previous versions of CentOS and Ubuntu are not supported because Tableau Server requires systemd for process management.

Custom kernels are not supported.

In a multi-node installation of Tableau Server, all of the computer nodes where you are installing Tableau must run Linux and the same distribution of Linux.

Note: You cannot install Tableau Server on a combination of Linux and Windows computers.

Installation directory

The core Tableau Server bits are installed in the /opt directory by default. You can change the install directory on RHEL-like systems, but cannot change this on Ubuntu. You cannot specify a symbolic link or a directory location on a Network File System (NFS) volume. The directory where you install Tableau Server must have at least 15 GB of free disk space. If you attempt to install Tableau Server on a computer that does not have enough space, the Tableau Server package will install, but you will be unable to continue with setup.

Data directory

By default, Tableau Server will create a data directory for all content and extracts that are managed by Tableau. The directory is created at /var/opt/tableau/tableau_server.

You can specify a different directory for data (extract) storage during installation. If you plan to use a different directory, do not create the directory. Instead, let Tableau Server setup create the directory. The data directory requires specific permissions that are set during the installation process.

To change the data directory, you must pass a flag along with the data directory path when you run the initialize-tsm script. See Help Output for initialize-tsm Script.

If you are changing the default data directory:

  • Do not specify a symbolic link or a data directory location on a Network File System (NFS) volume.
  • Do not specify a data directory location with a path that includes a period ("."). If there is a period in the path, initialization will fail.

Important: You cannot change the data directory location after you've run initialize-tsm. The data directory location will persist for the life of the deployment, including subsequent upgrades.

Tableau Prep Conductor

Tableau Prep Conductor is one of the process on Tableau Server. It runs a flow, checks connection credentials, and sends alerts if a flow fails. Tableau Prep Conductor leverages the scheduling and tracking functionality of Tableau Server so you can automate running flows to update the flow output instead of logging into Tableau Prep Builder to manually run individual flows as your data changes.

Tableau Prep Conductor is licensed separately and is available through the Data Management Add-on license. For more information on Tableau Prep Conductor licensing, see Licensing Tableau Prep Conductor.

It is recommended that you enable Tableau Prep Conductor on a dedicated node. It is recommended that you enable Tableau Prep Conductor on a dedicated node to run flows. For more information:

Additional requirements

Make sure that your environment also meets the following additional requirements:

Hostname

The hostname of the computer where you install Tableau Server must be unique in your environment, and once you have installed Tableau Server the hostname cannot change. Additionally, your domain name server (DNS) must be able to resolve the hostname.

The hostname of the server must not change after you start Tableau Services Manager during the setup process. For example, this might happen if you use the cloud-init package to initialize a virtual machine, and you install Tableau Server on that virtual machine.

Hostnames that include underscores (_) are not supported by Tableau Server on Linux.

Static IP address

The computer where you install Tableau Server must have a static IP address.

Database drivers

To connect to specific data sources, the computer where you install Tableau Server must have the correct database drivers installed. For more information, see Database Drivers.

Available ports

TSM and Tableau Server each require an available TCP port in order for you to access them. TSM defaults to port 8850, and the Tableau Server Gateway service defaults to port 80. We strongly recommend that you ensure that both port 8850 and 80 are not in use on your system before installing Tableau Server. If those ports are not available, the TSM and gateway ports may be dynamically remapped to different port numbers, and there is currently no interface for displaying which port they have been remapped to.

See Tableau Services Manager Ports.

Local firewall configuration

If you are running a firewall on the computer where you will be installing Tableau Server, then you will need to open the following default ports for Tableau Server traffic. All port numbers, except 443 and 8850, can be changed.

Port TCP/UDP Used by ... TYPE OF INSTALLATION
All

Distributed / High Availability

80 TCP Gateway X  
443 TCP SSL. When Tableau Server is configured for SSL, the application server redirects requests to this port. Do not change this port. X  
8850 TCP Tableau Services Manager. Do not change this port. X  
8060 TCP PostgreSQL database. X  
8061 TCP PostgreSQL backup verification port X  
8000-9000 TCP Range of ports reserved by default for dynamic mapping of Tableau processes   X
27000-27009 TCP Range of ports used by Tableau Server for License service. This range must be open on the node running the License service and accessible from other nodes. By default, the initial node runs the License service. X  

See Tableau Services Manager Ports and Configure Local Firewall.

System user and groups

Tableau Server on Linux uses one unprivileged user, and two groups for proper operation. Tableau will create the default account and groups during setup. Alternatively, you can specify existing accounts. See System user and groups.

Sudo and root access

All installation tasks and administrative tasks for Tableau Server must be run as root. Often this is accomplished using the sudo command, but running the commands directly as the root user is also possible.

To install Tableau Server with the root account, you must specify a user account during installation. The account will be used for managing TSM. Specify the account by running the initialize-tsm script with the -a option. See Help Output for initialize-tsm Script.

Account password

The user account that you use to install and administer Tableau Server must be able to authenticate with a password. That is, the user must not use another means of authenticating (for example public key authentication).

If the account you are using to install and initialize Tableau Server does not have a password, you can set one using the passwd command:

                sudo passwd $USER
            

Port access requirements

If you want to install Tableau Server remotely, for example by means of SSH, ensure that the following ports are open:

  • 8850. The port used for the Tableau Services Manager (TSM) web interface. You can use this interface to configure Tableau Server.
  • 80. The port used for the main Tableau Server web interface.

The Tableau Server installer attempts to open these ports during the installation process, but it can only open these ports for the firewalld firewall. If your computer runs another firewall, you must open the ports before you install.

Virtual Container environments

Installation of Tableau Server in virtual container environments such as Docker have not been tested and are not supported. Tableau Server on Linux will not function as expected if installed in these environments.

Package requirements

Systemd

Tableau Server requires systemdto manage services. This package is installed by default on CentOS 7 and Ubuntu 16. If you decide to test Tableau Server on a modified version of these distributions, you can run the following command to confirm that systemd is installed:

                whereis systemd
            

If systemdis installed, the installation location is displayed. For example, you might see the following output:

                systemd: /usr/lib/systemd /etc/systemd /usr/share/systemd /usr/share/man/man1/systemd.1.gz
            

If you have systemd installed but the Tableau installer is failing requirements checks for systemd, it's likely that systemd is not running. To verify that systemd is running, run the following command:

ls /run/systemd

The output will be a list of files and directories. If systemd is running, the output will include system. If system is not in the output, then systemd is not running.

Continue to the next step: Install and Configure Tableau Server.

Thanks for your feedback! There was an error submitting your feedback. Try again or send us a message.