| Syntax | Description |
|---|---|
tableau_<product_installer_name>.exe /option1 /option2 PROPERTY1 PROPERTY2 | Run the command as an administrator from the directory where the .exe file is located or specify a full path to the location of the .exe file on the computer. Do not run from a shared directory. For a list of supported installer options see Installer options. For a list of supported installer properties, see Installer properties.
Example:
This command installs Tableau version 2026.2 in quiet mode (doesn’t display prompts, UI or the licence dialog). It finishes the install without a restart, accepts the end-user licence agreement (EULA) and sets error reporting and usage reporting to off. |
| Syntax | Description |
|---|---|
--activate <key> | Activate the product using the supplied product key. Exits with code 0 on success. Otherwise exits with an error code. Also accepts single-dash (-activate). To activate the product during installation, add a single command line that includes the installer option ACTIVATE_KEY ‘<key>’ and enter the product key in quotes. |
--register | Register the product. Also accepts single-dash (-register). To register Tableau from the command line, you need to prefill the registry (Windows) or .plist (Mac) values on each computer that will run Tableau Prep Builder. For Windows, you can register the product during installation by adding a single command line that includes the installer option REGISTER="1". For more information, see Register Tableau Desktop and Tableau Prep Builder. |
--check-license | Display activation UI if unlicensed. |
--refresh | Updates licences with the date when their current maintenance period expires and stops expiry messages. Exits with code 0 on success. Also accepts single-dash (-refresh). Windows: Run tableau.exe with the MacOS: Run the |
--return <key> | Deactivate the supplied product key so it can be reused. Also accepts single-dash (-return). Windows: Run tableau.exe with the MacOS: Run the |
| Syntax | Description |
|---|---|
--settings-file <file location> | Load application configuration settings from the given file. Can be specified multiple times to support layered configurations such as when you have a global proxy server configuration used by everyone and a specific database configuration used for a flow. .json file example: {
"connection-sources":[
{
"endpoint":"prod-db-server.company.com",
"username":"service_account_admin",
"password":"secure_password_123"
}
]
}Example command: Windows: MacOS |
--repository-location <file path> | Set the repository directory. By default during installation, Tableau Prep creates a folder in your Documents folder called My Tableau Prep Repository. This folder includes folders for flows, datasources, connections, as well as log files, and a temporary cache. In server or automation environments, you can use this command to specify an alternative repository location and point the flow run to it. Example: Windows: " MacOS: |
--user-data-directory <location> | Directory used for storing Electron application data. While As an admin, use this flag if you are running Tableau Prep Builder in a high-concurrency environment where multiple processes need isolated application states, or when troubleshooting persistent session-lock errors on a headless server. Note: When you run the command, it automatically creates the folder specified in the Example: Windows: MacOS: |
| Syntax | Description |
|---|---|
--tfl<file> | Open the specified .tfl flow file. Use double quotes if your file path includes spaces. Example: Windows: "C:\Program Files\Tableau\Tableau Prep Builder 2026.2\Tableau Prep Builder.exe" -tfl "C:\Users\jsmith\Documents\My Flows\Clean_Sales_Data.tfl" MacOS: /Applications/Tableau\ Prep\ Builder\ 2026.2.app/Contents/MacOS/Tableau\ Prep\ Builder -tfl "/Users/jsmith/Documents/My Flows/Clean_Sales_Data.tfl" |
--tflx<file> | Open the specified .tflx packaged flow file. Example: Windows: MacOS: |
| Syntax | Description |
|---|---|
-c, --connections <path> | The path to the .json file containing the credentials for your data sources and servers. Tableau Prep Builder uses information from the flow file and from the credentials .json file to run the flow when you have remote connections. For more information, see Credentials .json file requirements. If you connect to a snowflake database, be sure to include any specific parameters like Role, Warehouse and sometimes OAuth tokens or External Browser authentication. .json settings file example - Snowflake: {
"connection-sources":[
{
"endpoint":"company_account.snowflakecomputing.com",
"username":"SVC_TABLEAU_PREP",
"password":"EncryptedPassword123",
"attributes":{
"warehouse": "DATA_LOAD_WH",
"role": "TRANSFORM_ROLE"
}
}
]
} Example: Windows: MacOS: |
- p, - - parameters | The path to a .json file that overrides the default parameter values in your flow. This is a separate file from your credentials.json file and includes your parameter names and values. For more information, see ‘Run flows that include parameter values’ in Credentials .json file requirements. Example: Windows: MacOS: |
-t,--tflFile <file path> | The path to your Tableau Prep flow file. |
-inc, --incrementalRefresh | If you don’t have Tableau Prep Conductor enabled on your server to schedule flow runs, you can use this command to run your flow using incremental refresh. For more information, see ‘Run the flow with incremental refresh enabled’. Example: Windows: MacOS: |
| Syntax | Description |
|---|---|
--version | Outputs the current version of the Tableau Prep Builder CLI and immediately terminates the process. |
-d, --debug | Enables debug mode. Generates detailed logs in the repository folder for troubleshooting. Log files are stored in: My Tableau Prep Builder Repository\Command Line Repository\Logs Example: Windows: MacOS: |
-dsv, --disableSslValidation | Disables SSL certificate validation (useful for certain internal server environments). When running this option on MacOS, a dialog may appear asking for the keychain user and password. Starting with Tableau Prep Builder version 2019.3.2, you can pass in this additional parameter to disable this keychain dialog. Example: MacOS: |
-h, --help | Displays the help menu for the command-line options. |