---
schema_version: "1"
id: e4aceb900087423e47f0ff347eed9f6d3e89fca616645c534cbd410f4aa08b5c
title: Remove Tableau Server from Your Computer
collection: tableau
version: current
locale: en-us
portal_url: https://docs.salesforce.com/tableau/current/en-us/server-linux/remove_tableau.md
canonical_url: https://help.tableau.com/current/server-linux/en-us/remove_tableau.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 4c8c0387abefd88751a5bbc375907caed4a525a0091974deb1d5ae36b6f5c5df
description: Completely remove Tableau Server from a computer using the obliterate script.
---
[Skip to main content](#main-content)

# Remove Tableau Server from Your Computer

**Warning:** The steps below _completely remove_ Tableau Server on Linux, and delete users and groups created by `initialize-tsm`, all related data, and configuration information. This includes any files in `/tmp` or `/var/tmp` that are owned by users configured in `/etc/opt/tableau/tableau_server/environment.bash` as privileged and unprivileged users (by default, `tsmagent` and `tableau`). Tableau Server licenses are also deactivated, unless you omit the `-l` option when running the command shown below and the computer is connected to the internet.

If you want to uninstall a particular Tableau Server package to free up disk space (after upgrading, for example), see [Uninstall Tableau Server](https://help.tableau.com/current/server-linux/en-us/uninstall_server.htm).

As part of the regular installation of Tableau Server, a script is installed that provides you a way to completely remove Tableau and all associated files from your computer. This is something you would only do if you did not care about your Tableau data, configuration, or log files, or if you are working with Tableau Technical Support and need to reinstall Tableau Server after an installation or upgrade attempt fails. The obliterate script will not remove any drivers you installed separately, even those you installed to use with Tableau Server.

The `tableau-server-obliterate` script is intended for when you want to completely remove Tableau Server from your computer. You might want to do this for a couple of different reasons:

- You no longer want Tableau Server installed on the computer. Use the `tableau-server-obliterate` script to remove Tableau Server completely. If this is the case, and the computer is connected to the internet, you can include a `-l` option to deactivate the Tableau Server license.
- Troubleshooting Tableau Server installation problems—If you run into issues installing Tableau, you may need to use the `tableau-server-obliterate` script to completely remove Tableau Server from your computer before reinstalling. Doing this will clean up any older settings or states (such as the `/etc/opt/tableau/tableau_server/environment.bash` file) and allow you to reinstall on a "clean" computer. If you are doing this, you can leave off the `-l` option to preserve licensing information on the computer. When you omit the `-l` option, you will not need to activate your license when you reinstall Tableau Server.

## What tableau-server-obliterate does

The intent of the `tableau-server-obliterate` script is to completely remove Tableau Server from your computer. This includes files, system settings and configurations, and, if you specify, licensing information.

When you run `tableau-server-obliterate`, the following steps are taken:

- Uninstall is run for all installed versions of Tableau Server (yum erase or apt-get remove).
- Most contents of the data directory is removed (by default `/var/opt/tableau/tableau_server`). Backup and log files are preserved by default. See the section below, "Preserving Tableau Server backup and log files."
- All semaphores and shared memory segments are deleted.
- All temp files owned by the "tableau" user are deleted from `/tmp` and `/var/tmp`.
- All users and groups created during install are deleted.
- `/etc/opt/tableau` is deleted.
- Trusted certificates are removed from `/etc/pki/ca-trust/source/anchors/TableauServer` and `/usr/share/ca-certificates/tableau`
- Configuration files are removed from:
    - /etc/sysctl.d/99-tableau-server.conf
    - /etc/profile.d/tableau\_server\*
    - /etc/security/limits.d/99-tableau\_server\*
    - /etc/systemd/logind.conf.d/tableau\_server\*
    - /usr/share/bash-completion/completions/tsm
    - etc/bash\_completion.d/tsm
    - /usr/share/bash-completion/completions/tabcmd
    - /etc/bash\_completion.d/tabcmd
    - /run/tableau
    - /usr/lib/tmpfiles.d/tableau-server.conf
- All server licenses are deactivated if you use the `-l` option and the computer is connected to the internet. This option does not work in offline situations.

### Preserving Tableau Server backup and log files

Prior to version 2020.1 of Tableau Server, running the `tableau-server-obliterate` script deleted all content from the Data directory. Beginning with version 2020.1, the default behavior of the `tableau-server-obliterate` script has changed: the script copies and saves Tableau Server backup and log files to the `logs-temp` directory. The default location for the logs-temp directory is at `/var/opt/tableau/logs-temp`. You can set options on the script to disable this new functionality.

To change the default behavior and to remove backup or log files, include on of the following options when running the `tableau-server-obliterate` script:

- `-k` Do not copy backups to logs-temp directory.
- `-g` Do not copy logs to logs-temp directory.
- `-a` Do not copy anything to logs-temp directory.

## Running the tableau-server-obliterate script

You can completely remove Tableau Server from a computer, either preserving the licensing information, or removing the licensing information along with all other aspects of Tableau Server. You might want to preserve licensing if you are going to reinstall Tableau Server on the same computer.

An older version of `tableau-server-obliterate` may miss files from new versions of Tableau Server. Always run the obliterate script for the version of Tableau Server that is installed on the computer.

### To completely remove Tableau Server without removing server licensing

The example script in this procedure also includes the `-a` option to remove Tableau Server backup and log files.

**Note:** If you plan to reinstall Tableau Server and [Activate Tableau Server Using the Authorization-To-Run (ATR) Service](https://help.tableau.com/current/server-linux/en-us/atr_service.htm), we recommend that you remove licensing information before reinstalling and activating Tableau Server using Server ATR.

1. On the initial node, open a terminal session.
2. Run the `tableau-server-obliterate` script:
    
    `sudo /opt/tableau/tableau_server/packages/scripts.<version_code>/tableau-server-obliterate -a -y -y -y`
    
    **Note:** If you have already uninstalled Tableau Server and now you want to remove it, run the copy of the `tableau-server-obliterate` script located in the `/var/tmp` directory. If the script is not in that directory, reinstall the Tableau Server package and then run the `tableau-server-obliterate` script.
    
    If you have a multi-node (distributed) installation of Tableau Server, run the `tableau-server-obliterate` script on each node in the cluster.
3. Restart each computer you ran the `tableau-server-obliterate` script on.

### To completely remove Tableau Server and licensing

The example script in this procedure also includes the `-a` option to remove Tableau Server backup and log files.

1. On the initial node, open a terminal session.
2. Deactivate any active product keys.
    
    `[tsm licenses deactivate](https://help.tableau.com/current/server-linux/en-us/cli_licenses_tsm.htm#TSMDeactivate) -k <product_key>`
3. Run the `tableau-server-obliterate` script:
    
    `sudo /opt/tableau/tableau_server/packages/scripts.<version_code>/tableau-server-obliterate -a -y -y -y -l`
    
    The `-l` option removes all licensing files from the computer if the computer is connected to the internet. The script first attempts to deactivate any active licenses, but it will remove all licensing information whether or not deactivation was successful. This is why we recommend you run the `tsm licenses deactivate` command before running the obliterate script.
    
    **Note:** If you have already uninstalled Tableau Server and now you want to remove it, run the copy of the `tableau-server-obliterate` script located in the `/var/tmp` directory. If the script is not in that directory, reinstall the Tableau Server package and then run the `tableau-server-obliterate` script.
    
    If you have a multi-node (distributed) installation of Tableau Server, run the `tableau-server-obliterate` script on each node in the cluster. You do not need to deactivate licenses on any additional nodes.
4. Restart each computer you ran the `tableau-server-obliterate` script on.