Error during installation: "Setup failed to install Tableau Server. You will need to uninstall Tableau Server before you try again."

Published: 21 Jan 2016
Last Modified Date: 08 Jul 2022


When upgrading Tableau Server on the same hardware where the previous version was installed, the following error might be encountered:
Setup failed to install Tableau Server.  You will need to uninstall Tableau Server before you try again.


Tableau Server


Perform a clean installation of Tableau Server.

Important: Before performing the below steps to completely uninstall Tableau Server, ensure that you have a current backup of your data.

  1. Uninstall the existing Tableau Server using the Add/Remove Programs in the Control Panel. If you have a distributed environment, use Add/remove Programs on your primary machine.
    Note: Uninstalling removes the application software, but leaves your data and configuration settings on the computer.
  2. Manually delete the versioned Tableau Server directory and Program Data directory. 
    • C:\Program Files\Tableau\Tableau Server
    • C:\ProgramData\Tableau\Tableau Server
    Important: Deleting this directory removes your existing content so that a new installer does not try to import it into the new server.
  3. After completely uninstalling Tableau Server, proceed with installing the new version of Tableau Server.
  4. After installation completes successfully, you can then restore your content with the tabadmin restore command as described in Restore from a Backup.
Did this article resolve the issue?