---
schema_version: "1"
id: 357d1aad5581236bd9d3d511bcefa4b015ebe9ed1bf9465ceb45876d0a82d99e
title: Single-Server Upgrade -- Run Setup
collection: tableau
version: next
locale: en-gb
portal_url: https://docs.salesforce.com/tableau/next/en-gb/server-linux/server-upgrade-baseline-singlenode-setup.md
canonical_url: https://help.tableau.com/v0.0/server-linux/en-gb/server-upgrade-baseline-singlenode-setup.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 91e17b5188d40bbf7b1c52fdbd0af0f6c6898f3d31ea4413fab499714073a706
description: Run Setup to upgrade a single-node Tableau Server installation.
---
[Skip to main content](#main-content)

# Single-Server Upgrade -- Run Setup

## Run Setup

Follow these steps to upgrade a single-node installation of Tableau Server.

1. Log on as a user with sudo access to the computer you are upgrading.
2. Navigate to the directory where you copied the `.rpm` or `.deb` Tableau Server package.
3. Use the package manager to install the Tableau Server package.
    
    You must install the new version to the same location as the existing version. The install location must be the same on all nodes. Do not install to a location using a symbolic link or to a directory on a Network File System (NFS) volume.
    
    - On RHEL-like distributions, including CentOS, you have the option to install Tableau to a non-default location.
        
        - **Default location**—To install to the default location (`/opt/tableau/tableau_server`), run the following commands, where `<version>` is formatted as major-minor-maintenance (ex: `2025-3-5`):
            
            `sudo yum update`
            
            `sudo yum install tableau-server-<version>.x86_64.rpm`
        - **Non-default location** – To install to a non-default location, you must use `rpm -i`. You will also need to install all dependent packages. See the note below.
            
            Run the following command:
            
            sudo rpm -i --prefix /preferred/install/path tableau-server.rpm
        
        **Note:** When you use `yum` to install Tableau Server, all dependent packages are automatically downloaded and installed. This is the preferred method for installing Tableau. If you want to install to a non-default location, or your organisation does not allow you to use `yum` and you must install using `rpm -i`, you must also install all dependent packages separately. For information about installing dependent packages, see [Installing Tableau Server on an Air-Gapped Computer Running Linux](https://help.tableau.com/v0.0/server-linux/en-gb/install_air_gapped.htm#InstallAirgap).
    - On Ubuntu, run the following commands, where `<version>` is formatted as major-minor-maintenance (ex: `2019-2-5`):
        
        sudo apt-get update
        sudo apt-get upgrade
        sudo apt-get -y install gdebi-core
        sudo gdebi -n tableau-server-<version>\_amd64.deb
4. Run the upgrade script.
    
    If Tableau Server is not stopped when you run the script, the script will let you know, and will offer to stop the server. You can also choose to stop the server before running the script using the `tsm stop` command. Tableau Server must be stopped to complete the upgrade.
    
    sudo /opt/tableau/tableau\_server/packages/scripts.<version\_code>/upgrade-tsm --accepteula
    
    where `<version_code>` is the long form of new version you are upgrading to, for example `scripts.20183.18.1128.2033`.
    
    When you upgrade, the script is run using the account you are logged in with. If you are prompted, enter your password. For more information, see [What's Changed - Things to Know Before You Upgrade](https://help.tableau.com/v0.0/server-linux/en-gb/upgrade_know_before.htm#NoPasswordUpgrade-19-3). You can specify a different user with administrative permissions using the `-u` option and specifying a user with administrative permissions on the computer where the initial node is installed. You will be prompted for the password for the administrative user.
    
    To see all the options available for the `upgrade-tsm` script, use the `-h` option. For example: 
    
    sudo /opt/tableau/tableau\_server/packages/scripts.<version\_code>/upgrade-tsm -h
5. After the upgrade is completed, exit the terminal session and log in again. This ensures that your session will be using the updated TSM version.
6. Start Tableau Server:
    
    `tsm start`

Continue to [Verify Tableau Server Upgrade](https://help.tableau.com/v0.0/server-linux/en-gb/server-upgrade-baseline-verify-ug.htm).