---
schema_version: "1"
id: 4335db8253be7d6723b082d2d815f7bd15c783bca85964209d3f233f0d220641
title: Single-Server Upgrade -- Run Setup
collection: tableau
version: next
locale: en-us
portal_url: https://docs.salesforce.com/tableau/next/en-us/server-linux/server-upgrade-baseline-singlenode-setup.md
canonical_url: https://help.tableau.com/v0.0/server-linux/en-us/server-upgrade-baseline-singlenode-setup.htm
source_site: help.tableau.com
content_type: documentation
content_hash: f7f14d739d66e90caf4cc9815a3b4ef1a5f6c0cc0a97068efed87cc59b0684bc
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 organization 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-us/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 runs 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-us/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-us/server-upgrade-baseline-verify-ug.htm).