---
schema_version: "1"
id: d52f58341cd1638a2053be0751a831c9cdec9bb242aa7cbfafae8b4cf1573ac9
title: tabcmd
collection: tableau
version: next
locale: en-us
portal_url: https://docs.salesforce.com/tableau/next/en-us/server-linux/tabcmd.md
canonical_url: https://help.tableau.com/v0.0/server-linux/en-us/tabcmd.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 74873e34895d4b4d5a3936440c58350bf6f9ac39e7d447e175052a19d8ff02e5
description: Install and use the tabcmd command-line utility for Tableau.
---
[Skip to main content](#main-content)

# tabcmd

**Note:** The tabcmd command-line utility version 2.0 is available at [Tableau tabcmd](https://tableau.github.io/tabcmd). This new version allows you to run tabcmd commands on MacOS and Linux, and to authenticate using personal access tokens (PATs). Version 2.0 is built on public endpoints available in the Python-based Tableau Server Client (TSC). This latest version has limited support for Tableau Server.

Tableau provides the tabcmd command-line utility which you can use to automate site administration tasks on your Tableau Server site. For example, creating or deleting users, projects, and groups.

**Note:** In Tableau versions prior to 2024.1, tabcmd version 1 does not work for exporting vizzes.

This utility is included with Tableau Server, and is automatically installed on the server nodes. You can also run it from other computers, even computers that are not part of your Tableau Server installation, but to do so you need to download the tabcmd installer from the Tableau website. For more information, see [Install tabcmd](#tabcmd-install) below.  

## Install tabcmd

**Note:** These instructions are for installing the tabcmd 1.0 command-line utility. To install the tabcmd 2.0 command-line utility, go to [Tableau tabcmd](https://tableau.github.io/tabcmd) (new window).

When Tableau Server or Tableau Cloud is upgraded to a new version, if an updated version of tabcmd is required, you can download it from the Tableau _Server_ Releases page on the Tableau website.

For Tableau Server, we recommend you download the version that matches your server version. For Tableau Cloud, we recommend you always download the latest version to avoid issues caused by version incompatibilities. In either case, using an out of date version of tabcmd can cause errors and unpredictable results.

1. Open a web browser and go to the [Tableau Server Releases](https://www.tableau.com/support/releases/server) page. Go to this page even if you use Tableau Online.
2. If you're using:
    
    - **Tableau Cloud**, use [Tableau tabcmd 2.0](https://tableau.github.io/tabcmd) (new window).
    - **Tableau Server (Windows or Linux):** select the release that matches your server version.
    
    In either case, if the expanded information shows maintenance releases, select the latest maintenance release or the one that matches your server version.
    
    ![Select the server version you use (latest release for Tableau Cloud)](/tableau/next/en-us/server-linux/en-us/Img/tabcmd_download1.png)
    
    This takes you to the release notes page, called Resolved Issues, where you can read about security improvements and resolved issues.
3. Scroll to the **Download Files** section under the resolved issues, select the tabcmd download link that is compatible with the computer on which you’ll run the tabcmd commands. 
    
    ![Select the tabcmd installer for the computer you'll use it on (32- or 64-bit)](/tableau/next/en-us/server-linux/en-us/Img/tabcmd_download.png)
    
    The remaining steps refer to this computer as “the tabcmd computer.”
4. Save the installer to the tabcmd computer, or a location accessible from that computer (a mounted drive, for example).
5. Complete the installation steps as appropriate for the operating system of the tabcmd computer:
    
    - Windows
        
        By default tabcmd is installed to `C:\Program Files\Tableau\Tableau Server\<version>\extras\Command Line Utility`. You can change this during installation and recommend that you install tabcmd to a folder named `tabcmd` at the root of the C:\\ drive (`C:\tabcmd`). This can make it easier to locate and run, and will accommodate some limitations with the Windows operating system if you add the tabcmd directory to the Windows PATH.
        
        **Note** The tabcmd Setup program does not add the tabcmd directory to the Windows PATH variable. You can add it manually, or you can include the full path to tabcmd each time you call it.
        
        You can install tabcmd in two ways on Windows:
        
        - Double-click the installer to follow the steps in the UI:
            
            1. Accept the license agreement.
            2. If you want to install to a non-default location, click Customize and type or browse to the location you want to install tabcmd to.
            3. Click Install.
                
                If you are prompted by Windows Defender Firewall or User Account Control, click **Allow access**.
        - Run the installer from a command prompt:
            
            1. Open a command prompt as administrator on the tabcmd computer.
            2. Navigate to the directory where you copied the tabcmd installer.
            3. Install tabcmd:
                
                tableau-setup-tabcmd-tableau-<version\_code>-x64.exe /quiet ACCEPTEULA=1
                
                To install to a non-default location:
                
                tableau-setup-tabcmd-tableau-<version\_code>-x64.exe /quiet ACCEPTEULA=1 INSTALLDIR="<path\\to\\install\\directory>"
                
                For example:
                
                tableau-setup-tabcmd-tableau-<version\_code>-x64.exe /quiet ACCEPTEULA=1 INSTALLDIR="C:\\tabcmd"
                
                For a complete list of command line options you can use with the tabcmd installer, run the installer with a /?. For more information on tabcmd installer command line options, see [Install Switches and Properties for tabcmd (Windows)](https://help.tableau.com/v0.0/server-linux/en-us/tabcmd_install_flags.htm).
        
        The tabcmd Setup program creates logs in `C:\Users\<user>\AppData\Local\Temp` you can use if you have problems installing tabcmd. The logs use the naming convention `Tableau_Server_Command_Line_Utility_(<version_code>)_##############.log`.
    - Linux
        
        **Note:** To run tabcmd on a Linux computer, you must have Java 11 installed. On RHEL-like systems, this will be installed as a dependency when you install tabcmd. On Ubuntu systems, you need to install Java 11 separately if it is not already installed.  
          
        As of July 2022, Debian distributions are no longer supported. For more information, see [this Tableau Community post](https://community.tableau.com/s/news/a0A4T0000011xDOUAY/debian-end-of-life).
        
        1. Log on as a user with sudo access to the tabcmd computer.
        2. Navigate to the directory where you copied the `.rpm` or `.deb` package that you downloaded.
            
            - On RHEL-like distributions, including CentOS, run the following command:
                
                `sudo yum install tableau-tabcmd-<version>.noarch.rpm`
            - On Ubuntu, run the following command:
                
                `sudo apt-get install ./tableau-tabcmd-<version>_all.deb`
    
    To uninstall tabcmd from a Linux computer, see the documentation for the Linux variety you are running.
6. (Optional) Add the fully qualified location where tabcmd is installed to your system path to allow you to run tabcmd commands without changing to that location, or specifying the location with each command. Steps to do this depend on the type and version of your operating system. For more information, see [PATH\_(variable)](https://en.wikipedia.org/wiki/PATH_\(variable\)).

## How to use tabcmd

The basic steps for using tabcmd are as follows:

1. Open the Command Prompt as an administrator.
    
    **Note:** Do not use PowerShell to run tabcmd commands on Windows. Using PowerShell can cause unexpected behavior.
2. On a Windows computer, if you installed tabcmd on a computer other than the initial node, change to the directory where you installed tabcmd.
    
    On a Linux computer, you do not need to change to the install directory.
3. Run the tabcmd command.

When you use tabcmd, you must establish an authenticated server session. The session identifies the server or Tableau Cloud site and the user running the session. You can start a session first, and then specify your command next, or you can start a session and execute a command all at once.

**Important:** If you are using tabcmd to perform more than one task, you must run tasks one after another (serially), rather than at the same time (in parallel).

Commands (such as `login`) and the options (such as `-s`, `-u`, etc.) are not case sensitive, but the values you provide (such as `User@Example.com`) are case sensitive.

## Examples

The following command demonstrates starting a session with the Tableau Server named _tabserver.mycompany.com_:

tabcmd login -s http://tabserver.mycompany.com -u admin -p mypassword

The next example shows a command that deletes a workbook named _Sales\_Workbook_:

tabcmd delete "Sales\_Workbook" 

Here’s how to accomplish all of the above with one command—note that you do not need `login` here:

tabcmd delete "Sales\_Workbook" -s http://tabserver.mycompany.com -u admin -p mypassword 

A Tableau Server can run multiple sites. When a workbook is on the Default site of a multi-site server you don't need to specify Default, the above command is sufficient. However, if the command applies to something on a site other than Default, you need to specify the site ID for that site (see [login](https://help.tableau.com/v0.0/server-linux/en-us/tabcmd_cmd.htm#login)). Here's the same command for a workbook that's on the West Coast Sales site (site ID `wsales`):

tabcmd delete "Sales\_Workbook" -s http://tabserver.mycompany.com -t wsales -u admin -p mypassword 

The options `-s`, `-t`, `-u`, and `-p` are among the tabcmd global variables, which can be used with any command.

For more information, see [tabcmd Commands](https://help.tableau.com/v0.0/server-linux/en-us/tabcmd_cmd.htm).

## Status messages and logs

When a command is successful, tabcmd returns a status code of zero. A full error message for non-zero status codes is printed to **stderr**. In addition, informative or progress messages may be printed to **stdout**.

A full log named **tabcmd.log** that includes debugging, progress, and error messages is written to `<home dir>/.tableau/tabcmd/`.

**Important:** Tableau Support is unable to troubleshoot problems that are only reproducible in custom scripts. For assistance with your custom scripts, please visit the Tableau Community forums.

## Other articles in this section