---
schema_version: "1"
id: fcfdba53e25f08c101a4473ba8a3616d184bf5ad499b8f2261c8ba731e6021a2
title: Uninstall Tableau Server
collection: tableau
version: next
locale: en-gb
portal_url: https://docs.salesforce.com/tableau/next/en-gb/server-linux/uninstall_server.md
canonical_url: https://help.tableau.com/v0.0/server-linux/en-gb/uninstall_server.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 2b3c06719045e575d2dbfab0f943ba2e9302cc405da89f18db40438c315e3890
description: Uninstall a version of Tableau Server.
---
[Skip to main content](#main-content)

# Uninstall Tableau Server

Do not uninstall Tableau before upgrading. For details on upgrading, see [Upgrading Tableau Server (Linux)](https://help.tableau.com/v0.0/server-linux/en-gb/sug_plan.htm).

You can have multiple versions of Tableau Server installed at the same time. This allows you to run most of an upgrade while an existing version is running, and reduces downtime and impact to users. Once you have upgraded, you can uninstall your previous version. Doing this frees up disk space. You do not have to uninstall the previous version.

This article explains how to uninstall previous versions, after you've upgraded to a newer version.

## Uninstalling and completely removing Tableau Server

There are two primary "uninstall" scenarios that Tableau Server on Linux supports:

- **Uninstall Tableau Server:** _After you upgrade_ to a new version of Tableau Server you can uninstall your previous version to free up disk space. Continue reading for information about uninstalling Tableau.
- **Remove Tableau Server:** If you want to complete remove Tableau Server from a computer, you can use a script provided by Tableau to remove Tableau Server and all related files. This removes all data as well as server components, so should only be done if you know you want to reset the computer to a pre-Tableau state. You might need to do this if Technical Support recommends this step when troubleshooting an installation problem. We recommend you create a backup of your data before removing Tableau. Save the backup file to a safe location on a computer that is not part of your Tableau installation. Completely remove Tableau Server without uninstalling any version first. The script will uninstall all existing versions found on the computer. If you have already uninstalled your existing version and now want to completely remove Tableau, you can find the script to do so in a temporary location. For more details, see [Remove Tableau Server from Your Computer](https://help.tableau.com/v0.0/server-linux/en-gb/remove_tableau.htm).

## Uninstall a Tableau Server package

Use this procedure to free up disk space by uninstalling packages for previous Tableau Server versions after you have upgraded to a newer version of Tableau Server.

1. Look at the environment.bash file to confirm which version of Tableau Server is currently in use. At a command prompt, type:
    
    grep TABLEAU\_SERVER\_DATA\_DIR\_VERSION /etc/opt/tableau/tableau\_server/environment.bash
2. Determine which versions of the Tableau Server package are installed on your computer.
    
    - On RHEL-like distributions, including CentOS, run the following command:
        
        yum list installed tableau-server"\*"
    - On Ubuntu, run the following command:
        
        apt list --installed tableau-server"\*"
3. Remove the Tableau Server package with your package manager.
    
    - On RHEL-like distributions, including CentOS, run the following command:
        
        sudo yum remove tableau-server-<version>.x86\_64
    - On Ubuntu, run the following commands:
        
        ```
        sudo apt-get purge tableau-server-<version>
        ```

### Reinstall a Tableau Server package that was accidentally uninstalled

Do _not_ uninstall the package for your currently running version of Tableau Server. Doing so will make the server unusable. To completely remove Tableau Server and all its files, see [Remove Tableau Server from Your Computer](https://help.tableau.com/v0.0/server-linux/en-gb/remove_tableau.htm).

When you uninstall the Tableau Server package for the current instance of Tableau Server the following operations run:

- All files under /opt/tableau/tableau\_server are removed. These files are the unmodified installation files.
- Tableau Server services are stopped and disabled
- Service files for all Tableau Server services are persisted
- Data files are left in place

If you accidentally uninstall the package for your currently running version of Tableau Server, follow this procedure to correct the situation.

To reinstall after uninstalling the running instance of Tableau Server:

1. Reinstall the package for the version you accidentally uninstalled.
2. Run `initialize-tsm`.

## Other articles in this section