Before you install...
Tableau Server on Windows now includes Tableau Services Manager (TSM), which replaces the Configuration Utility and the tabadmin command line tool. If you need help for an earlier version of Tableau Server, see the Tableau Help page.
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.
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
Important: The disk space requirement cannot be checked until you initialize TSM.
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
Tableau Server is available in a 64-bit version. You can install Tableau Server on Windows Server 2019, Windows Server 2016, Windows Server 2012, Windows Server 2012 R2, or Windows Server 2008 R2. You may install Tableau Server on virtual or physical platforms.
Note: You cannot install Tableau Server on a combination of Linux and Windows computers.
By default, Tableau Server will install on the system drive. The drive where Windows is installed is the system drive. In most cases, the system drive is the C:\ drive. In this default case, Tableau Server will install into the following directories:
C:\Program Files\Tableau\Tableau Server\packages
Do not specify a symbolic link or a data directory location on a Network File System (NFS) volume.
Non-default installation locations
Rather than install onto the system drive, some organization install applications on a separate drive. During setup (or with automated installation), you can specify a different installation location. If you select a different installation drive or folder location during setup, then the data directory for Tableau Server will install into the same path. This means that if you install to a non-default location, the default
path will not be created.
If your existing installation is not in the default location, you need to tell the Setup program where to install the new version of Tableau Server. How you specify a non-default upgrade location when prompted by the Setup program depends on whether you browse to the location or type the path:
- If you browse to the install location, the Setup program takes that location and appends
\Tableau Serverto it, and then installs to files immediately below the
\Tableau Serverfolder. You can see the path that Tableau Server will be installed to when you are browsing, and you can edit that path if it is not correct (if, for example, you want or need to include a
If you type the install location, the Setup program accepts the path you type and installs to folders immediately below that path.
When you install to a non-default location, you must take the following into consideration:
You may need to configure Run As User permissions manually. If you do not use the predefined local account, NetworkServices, as the Run As User account, then you will need to set permissions for the account that you will be using. You must set these permissions after you install Tableau Server. See Verify Folder Permissions.
Log files are stored at
<installation path or drive>\data\tabsvc\logs.
path in default installation is converted to
<installation path or drive>\data\tabsvc\logs.
You will need to specify the same location when you upgrade to newer versions of Tableau Server. For more information, see Upgrade Tableau Server in a Non-Default Location.
Note:If you run Tableau Server on a VM, either locally, or in the cloud, be aware of the potential for complications related to licensing. If you are simply upgrading Tableau Server on the VM, you do not need to take any extra action related to licensing. If you plan to clone the VM to create either a new production or test environment to upgrade, you need to deactivate any Tableau Server licenses before cloning. If you do not do this, the new VM environment can end up with an untrusted license, and any attempts to upgrade will fail.
To clone a VM, make sure the Tableau Server is unlicensed (all licenses are deactivated). After cloning the VM, activate the Tableau license on the cloned VM and proceed with the upgrade.
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:
If you are installing a new Tableau Server, see Installing Tableau Server with Prep Conductor.
If you are adding Tableau Prep Conductor to an existing installation of Tableau Server, see Add Tableau Prep Conductor to your Tableau Server Installation.
Make sure that your environment also meets the following additional requirements:
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.
Static IP address
The computer where you install Tableau Server must have a static IP address.
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.
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.
If you are installing Tableau Server on a computer that's also running IIS (not a recommended deployment), you should modify the Tableau's gateway port number to avoid conflict with IIS. You can specify a different gateway port number during the setup process.
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|
Distributed / High Availability
|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|
|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|
For information about configuring the local Windows firewall, refer to the Microsoft product documentation.
The account that you use to run Setup must be a member of the Local Administrators group on the Windows computer where Tableau Server is installed.
After you install Tableau Server, you must also use an account with local administrator rights to run Tableau Services Manager (TSM) Web UI and CLI tools. Use TSM to configure the Tableau Server components that rely on OS-level access, such as processes, authentication, log files, licensing, and alerts. See Sign in to Tableau Services Manager Web UI.
Tableau-specific administration, such as importing users, creating sites, web authoring, etc. is performed by Tableau Server administrators. You can configure these administrative accounts by assigning roles to users after you install. The initial Tableau Server administrator account is created as part of the installation process. See Add an Administrator Account.
Run As User account
A Run As User account for the Tableau Server service to run under is useful if you’re using NT Authentication with data sources or if you’re planning on doing SQL Server impersonation. For more information, see Run As Service Account and SQL Server Impersonation.
In some organizations, Group Policy or other system management solutions are used to standardize permissions and accounts on application servers. If your organization runs a such a solution, be sure to configure the system to accommodate the folder permissions required by the Run As User account. See Verify Folder Permissions.
Antivirus software that scans directories used by Tableau Server can interfere with installation and ongoing use of Tableau Server. In some cases, this can result in installation failures, problems starting Tableau Server, or impacts to performance. If you plan to run antivirus software on the computer running Tableau Server, follow the recommendations in the Knowledge Base.
Continue to the next step: Install and Configure Tableau Server.